Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw yêu cầu Node 22.14 trở lên. Node 24 là runtime mặc định và được khuyến nghị cho cài đặt, CI và quy trình phát hành. Node 22 vẫn được hỗ trợ qua dòng LTS đang hoạt động. Script cài đặt sẽ tự động phát hiện và cài Node — trang này dành cho khi bạn muốn tự thiết lập Node và đảm bảo mọi thứ được nối đúng cách (phiên bản, PATH, cài đặt toàn cục).

​
Kiểm tra phiên bản của bạn

node -v
Nếu lệnh này in ra v24.x.x hoặc cao hơn, bạn đang dùng mặc định được khuyến nghị. Nếu in ra v22.14.x hoặc cao hơn, bạn đang dùng lộ trình Node 22 LTS được hỗ trợ, nhưng chúng tôi vẫn khuyến nghị nâng cấp lên Node 24 khi thuận tiện. Nếu Node chưa được cài đặt hoặc phiên bản quá cũ, hãy chọn một phương thức cài đặt bên dưới.

​
Cài đặt Node

Homebrew (khuyến nghị):
brew install node
Hoặc tải trình cài đặt macOS từ nodejs.org.
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 — đa ngôn ngữ (Node, Python, Ruby, v.v.)
Ví dụ với fnm:
fnm install 24
fnm use 24
Đảm bảo trình quản lý phiên bản của bạn được khởi tạo trong tệp khởi động shell (~/.zshrc hoặc ~/.bashrc). Nếu không, openclaw có thể không được tìm thấy trong các phiên terminal mới vì PATH sẽ không bao gồm thư mục bin của Node.

​
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 chưa nằm trong PATH của bạn.
1

Find your global npm prefix

npm prefix -g
2

Check if it's on your PATH

echo "$PATH"
Tìm <npm-prefix>/bin (macOS/Linux) hoặc <npm-prefix> (Windows) trong đầu ra.
3

Add it to your shell startup file

Thêm vào ~/.zshrc hoặc ~/.bashrc:
export PATH="$(npm prefix -g)/bin:$PATH"
Sau đó mở terminal mới (hoặc chạy rehash trong zsh / hash -r trong bash).

​
Lỗi quyền trên npm install -g (Linux)

Nếu bạn thấy 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: 
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 của bạn để áp dụng vĩnh viễn.

​
Liên quan