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

​
Node.js

OpenClaw yêu cầu Node 22.16 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 hiện tại. Script cài đặt sẽ tự động phát hiện và cài đặt Node — trang này dành cho những ai muốn tự thiết lập Node và đảm bảo mọi thứ được cấu hình đúng (phiên bản, PATH, cài đặt toàn cục).

​
Kiểm tra phiên bản

node -v
Nếu kết quả là v24.x.x hoặc cao hơn, bạn đang dùng phiên bản mặc định được khuyến nghị. Nếu là v22.16.x hoặc cao hơn, bạn đang dùng Node 22 LTS được hỗ trợ, nhưng vẫn nên nâng cấp lên Node 24 khi có thể. 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 pháp cài đặt dưới đây.

​
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 giúp bạn dễ dàng chuyển đổi giữa các phiên bản Node. Các tùy 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:
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 file 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 làm việc terminal mới vì PATH sẽ không bao gồm thư mục bin của Node.

​
Xử lý sự cố

​
openclaw: command not found

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

Tìm prefix toàn cục của npm

npm prefix -g
2

Kiểm tra xem nó có trong PATH không

echo "$PATH"
Tìm <npm-prefix>/bin (macOS/Linux) hoặc <npm-prefix> (Windows) trong kết quả.
3

Thêm vào file khởi động shell

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 gặp lỗi EACCES, hãy chuyển prefix toàn cục của npm sang thư mục có quyền ghi của người dùng: 
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 để thiết lập vĩnh viễn.
Last modified on March 22, 2026