Node.js

OpenClaw 需要 Node 22.16 或更新版本。Node 24 是預設且推薦的 runtime，用於安裝、CI 和發布流程。Node 22 透過 active LTS 線路仍受支援。安裝腳本會自動偵測並安裝 Node——這頁是給想自行設定 Node 並確認一切正確連接（版本、PATH、全域安裝）的人。

檢查版本

node -v

如果顯示 v24.x.x 或更高，你在推薦的預設版本上。如果顯示 v22.16.x 或更高，你在受支援的 Node 22 LTS 上，但我們仍建議在方便時升級到 Node 24。如果 Node 未安裝或版本太舊，選擇下方的安裝方式。

安裝 Node

macOS

**Homebrew**（推薦）：

```bash
brew install node
```

或從 [nodejs.org](https://nodejs.org/) 下載 macOS 安裝程式。

Linux

**Ubuntu / Debian：**

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

**Fedora / RHEL：**

```bash
sudo dnf install nodejs
```

或使用版本管理工具（見下方）。

Windows

**winget**（推薦）：

```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey：**

```powershell
choco install nodejs-lts
```

或從 [nodejs.org](https://nodejs.org/) 下載 Windows 安裝程式。

使用版本管理工具（nvm、fnm、mise、asdf）

版本管理工具讓你輕鬆切換 Node 版本。熱門選擇：

fnm — 快速、跨平台
nvm — macOS/Linux 上廣泛使用
mise — 多語言（Node、Python、Ruby 等）

fnm 範例：

fnm install 24
fnm use 24

警告： 確認版本管理工具已在 shell 啟動檔（~/.zshrc 或 ~/.bashrc）中初始化。否則 openclaw 在新終端 session 中可能找不到，因為 PATH 不會包含 Node 的 bin 目錄。

疑難排解

`openclaw: command not found`

幾乎都是因為 npm 的全域 bin 目錄不在 PATH 中。

步驟 1：找到全域 npm prefix

```bash
npm prefix -g
```

步驟 2：檢查是否在 PATH 中

```bash
echo "$PATH"
```

在輸出中尋找 `<npm-prefix>/bin`（macOS/Linux）或 `<npm-prefix>`（Windows）。

步驟 3：加入 shell 啟動檔

  #### macOS / Linux
    加入 `~/.zshrc` 或 `~/.bashrc`：

    ```bash
    export PATH="$(npm prefix -g)/bin:$PATH"
    ```

    然後開啟新終端（或在 zsh 中執行 `rehash` / 在 bash 中執行 `hash -r`）。

  #### Windows
    透過設定 → 系統 → 環境變數，將 `npm prefix -g` 的輸出加入系統 PATH。

`npm install -g` 權限錯誤（Linux）

如果看到 EACCES 錯誤，將 npm 全域 prefix 切換到使用者可寫入的目錄：

mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

將 export PATH=... 那行加入 ~/.bashrc 或 ~/.zshrc 使其永久生效。