OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Install overview

Node.js

OpenClaw yêu cầu Node 22.19+, Node 23.11+ hoặc Node 24+. Node 24 là môi trường chạy mặc định và được khuyến nghị cho quá trình cài đặt, CI và quy trình phát hành; Node 22 vẫn được hỗ trợ thông qua nhánh LTS đang hoạt động. Tập lệnh cài đặt tự động phát hiện và cài đặt Node — hãy sử dụng trang này khi bạn muốn tự thiết lập Node (phiên bản, PATH, cài đặt toàn cục).

Kiểm tra phiên bản

bash
node -v

v24.x.x trở lên là phiên bản mặc định được khuyến nghị. v22.19.x trở lên là nhánh Node 22 LTS được hỗ trợ (hãy nâng cấp lên Node 24 khi thuận tiện). Các bản dựng Node 23 trước v23.11.0 không được hỗ trợ. Nếu chưa cài đặt Node hoặc phiên bản nằm ngoài phạm vi được hỗ trợ, hãy chọn một phương thức cài đặt bên dưới.

Cài đặt Node

macOS

Homebrew (khuyến nghị):

bash
brew install node

Hoặc tải trình cài đặt macOS từ nodejs.org.

Linux

Ubuntu / Debian:

bash
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt-get install -y nodejs

Fedora / RHEL:

bash
sudo dnf install nodejs

Hoặc sử dụng trình quản lý phiên bản (xem bên dưới).

Windows

winget (khuyến nghị):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

Hoặc tải trình cài đặt Windows từ nodejs.org.

Sử dụng trình quản lý phiên bản (nvm, fnm, mise, asdf)

Trình quản lý phiên bản cho phép bạn dễ dàng chuyển đổi giữa các phiên bản Node. Các lựa chọn phổ biến:

  • fnm - nhanh, đa nền tảng
  • nvm - được sử dụng rộng rãi trên macOS/Linux
  • mise - hỗ trợ nhiều ngôn ngữ (Node, Python, Ruby, v.v.)

Ví dụ với fnm:

bash
fnm install 24fnm use 24

Khắc phục sự cố

openclaw: command not found

Điều này hầu như luôn có nghĩa là thư mục bin toàn cục của npm không có trong PATH.

  • Tìm tiền tố npm toàn cục

    bash
    npm prefix -g

  • Kiểm tra xem tiền tố có trong PATH hay không

    bash
    echo "$PATH"

    Tìm <npm-prefix>/bin (macOS/Linux) hoặc <npm-prefix> (Windows) trong kết quả đầu ra.

  • Thêm tiền tố vào tệp khởi động shell

    macOS / Linux

    Thêm vào ~/.zshrc hoặc ~/.bashrc:

    bash
    export PATH="$(npm prefix -g)/bin:$PATH"

    Sau đó mở một terminal mới (hoặc chạy rehash trong zsh / hash -r trong bash).

    Windows

    Thêm kết quả của npm prefix -g vào PATH hệ thống thông qua Settings → System → Environment Variables.

    • Lỗi quyền khi chạy npm install -g (Linux)

    Nếu gặp lỗi EACCES, hãy chuyển tiền tố toàn cục của npm sang một thư mục mà người dùng có quyền ghi:

    bash
    mkdir -p "$HOME/.npm-global"npm config set prefix "$HOME/.npm-global"export PATH="$HOME/.npm-global/bin:$PATH"

    Thêm dòng export PATH=... vào ~/.bashrc hoặc ~/.zshrc để duy trì thiết lập này lâu dài.

    Nội dung liên quan

    Was this useful?
    On this page

    On this page