> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Node.js

OpenClaw yêu cầu **Node 22.19+, Node 23.11+, hoặc Node 24+**. **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ợ thông qua nhánh LTS đang hoạt động. [Tập lệnh cài đặt](/vi/install#alternative-install-methods) sẽ tự động phát hiện và cài đặt 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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 lệnh in ra `v22.19.x` hoặc cao hơn, bạn đang dùng đường dẫn 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. Các phiên bản Node 23 trước `v23.11.0` không được hỗ trợ. Nếu Node chưa được cài đặt 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

<Tabs>
  <Tab title="macOS">
    **Homebrew** (được khuyến nghị):

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    brew install node
    ```

    Hoặc tải trình cài đặt macOS từ [nodejs.org](https://nodejs.org/).
  </Tab>

  <Tab title="Linux">
    **Ubuntu / Debian:**

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
    sudo apt-get install -y nodejs
    ```

    **Fedora / RHEL:**

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    sudo dnf install nodejs
    ```

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

  <Tab title="Windows">
    **winget** (được khuyến nghị):

    ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
    winget install OpenJS.NodeJS.LTS
    ```

    **Chocolatey:**

    ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
    choco install nodejs-lts
    ```

    Hoặc tải trình cài đặt Windows từ [nodejs.org](https://nodejs.org/).
  </Tab>
</Tabs>

<Accordion title="Using a version manager (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**](https://github.com/Schniz/fnm) - nhanh, đa nền tảng
  * [**nvm**](https://github.com/nvm-sh/nvm) - được dùng rộng rãi trên macOS/Linux
  * [**mise**](https://mise.jdx.dev/) - đa ngôn ngữ (Node, Python, Ruby, v.v.)

  Ví dụ với fnm:

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  fnm install 24
  fnm use 24
  ```

  <Warning>
    Đả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 chưa, `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.
  </Warning>
</Accordion>

## 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 nằm trong PATH của bạn.

<Steps>
  <Step title="Find your global npm prefix">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    npm prefix -g
    ```
  </Step>

  <Step title="Check if it's on your PATH">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    echo "$PATH"
    ```

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

  <Step title="Add it to your shell startup file">
    <Tabs>
      <Tab title="macOS / Linux">
        Thêm vào `~/.zshrc` hoặc `~/.bashrc`:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        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 của bạn qua Settings → System → Environment Variables.
      </Tab>
    </Tabs>
  </Step>
</Steps>

### 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ó thể ghi:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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` để đặt nó vĩnh viễn.

## Liên quan

* [Tổng quan cài đặt](/vi/install) - tất cả phương thức cài đặt
* [Cập nhật](/vi/install/updating) - giữ OpenClaw luôn cập nhật
* [Bắt đầu](/vi/start/getting-started) - các bước đầu tiên sau khi cài đặt