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

​
Node.js

OpenClaw requires Node 22 or newer. The installer script will detect and install Node automatically — this page is for when you want to set up Node yourself and make sure everything is wired up correctly (versions, PATH, global installs).

​
Kiểm tra phiên bản

node -v
Nếu lệnh này in ra v22.x.x hoặc cao hơn, bạn đã sẵn sàng. Nếu Node chưa được cài 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ị):
````
```bash
brew install node
```

Hoặc tải trình cài đặt macOS từ [nodejs.org](https://nodejs.org/).
````
Version managers let you switch between Node versions easily. Các lựa chọn phổ biến:
  • fnm — nhanh, đa nền tảng
  • nvm — được 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 22
fnm use 22
Hãy đả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). If it isn’t, openclaw may not be found in new terminal sessions because the PATH won’t include Node’s bin directory.

​
Xử lý 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 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ở một terminal mới (hoặc chạy rehash trong zsh / hash -r trong bash).

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

Nếu bạn thấy lỗi EACCES, hãy chuyển prefix toàn cục của npm sang một thư mục có quyền ghi cho 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 để áp dụng vĩnh viễn.