Node.js¶

OpenClaw yêu cầu Node 22 hoặc mới hơn. installer script sẽ tự động phát hiện và cài đặt Node — trang này dành cho trường hợp bạn muốn tự thiết lập Node và đảm bảo mọi thứ được cấu hình chính xác (phiên bản, PATH, cài đặt toàn cục).

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/).
````

Ubuntu / Debian:

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

**Fedora / RHEL:**

```bash
sudo dnf install nodejs
```

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

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](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.

bash npm prefix -g bash echo "$PATH"

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

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).
      </Tab>
      <Tab title="Windows">
        Thêm đầu ra của `npm prefix -g` vào PATH hệ thống qua Settings → System → Environment Variables.
      </Tab>
    </Tabs>
    ```

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.