Node.js

安裝程式腳本會自動偵測並安裝 Node — 此頁面適用於你想自行設定 Node，並確保所有內容都正確連線（版本、PATH、全域安裝）的情況。安裝程式腳本會自動偵測並安裝 Node——本頁適用於你想自行設定 Node，並確保一切正確連接（版本、PATH、全域安裝）的情況。

檢查你的版本

node -v

If this prints v22.x.x or higher, you’re good. 常見選項：

安裝 Node

macOS
Linux
Windows

Homebrew（建議）：

````
```bash
brew install node
```

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

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
```

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

winget（建議）：

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

**Chocolatey：**

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

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

Using a version manager (nvm, fnm, mise, asdf)

版本管理工具可讓你輕鬆切換不同的 Node 版本。常見選項： Popular options: Popular options:

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

以 fnm 為例：

fnm install 22
fnm use 22

Make sure your version manager is initialized in your shell startup file (~/.zshrc or ~/.bashrc). 請確保你的版本管理工具已在 Shell 啟動檔中初始化（~/.zshrc 或 ~/.bashrc）。若未初始化，新的終端機工作階段中可能找不到 openclaw，因為 PATH 不會包含 Node 的 bin 目錄。

Troubleshooting

`openclaw: command not found`

這幾乎總是表示 npm 的全域 bin 目錄未加入你的 PATH。

Find your global npm prefix

npm prefix -g

Check if it's on your PATH

echo "$PATH"

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

Add it to your shell startup file

macOS / Linux
Windows

加入至 ~/.zshrc 或 ~/.bashrc：

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

接著開啟新的終端機（或在 zsh 中執行 rehash／在 bash 中執行 hash -r）。

透過「設定 → 系統 → 環境變數」，將 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，以使設定永久生效。

說明

社群

環境與除錯

Node 執行階段

壓縮內部機制

開發者設定

文件中繼資料

Node.js

Node.js

檢查你的版本

安裝 Node

Troubleshooting

`openclaw: command not found`

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

​Node.js

​檢查你的版本

​安裝 Node

​Troubleshooting

​openclaw: command not found

​在 npm install -g 上的權限錯誤（Linux）

Node.js

檢查你的版本

安裝 Node

Troubleshooting

`openclaw: command not found`

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