跳轉到主要內容

​
Node.js

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

​
檢查你的版本

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

​
安裝 Node

Homebrew（建議）：
````
```bash
brew install node
```

或從 [nodejs.org](https://nodejs.org/) 下載 macOS 安裝程式。
````
版本管理工具可讓你輕鬆切換不同的 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。
1

Find your global npm prefix

npm prefix -g
2

Check if it's on your PATH

echo "$PATH"

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

Add it to your shell startup file

加入至 ~/.zshrc 或 ~/.bashrc：
export PATH="$(npm prefix -g)/bin:$PATH"
接著開啟新的終端機（或在 zsh 中執行 rehash／在 bash 中執行 hash -r）。

​
在 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，以使設定永久生效。