跳轉到主要內容
OpenClaw 需要 Node 22.16 或更新版本。Node 24 是安裝、CI 與發布工作流程的預設且建議執行環境。Node 22 仍透過現行 LTS 系列受到支援。安裝程式指令碼會自動偵測並安裝 Node - 本頁適用於你想自行設定 Node，並確認所有項目都已正確串接時使用（版本、PATH、全域安裝）。

​
檢查你的版本

node -v
如果輸出 v24.x.x 或更高版本，表示你使用的是建議的預設版本。如果輸出 v22.16.x 或更高版本，表示你使用的是受支援的 Node 22 LTS 路徑，但我們仍建議在方便時升級到 Node 24。如果尚未安裝 Node，或版本太舊，請從下方選擇一種安裝方式。

​
安裝 Node

Homebrew（建議）：
brew install node
或從 nodejs.org 下載 macOS 安裝程式。
版本管理器可讓你輕鬆切換 Node 版本。常見選項：
  • fnm - 快速、跨平台
  • nvm - 在 macOS/Linux 上廣泛使用
  • mise - 多語言工具（Node、Python、Ruby 等）
使用 fnm 的範例：
fnm install 24
fnm use 24
請確認你的版本管理器已在 shell 啟動檔中初始化（~/.zshrc 或 ~/.bashrc）。如果沒有初始化，新的終端機工作階段可能找不到 openclaw，因為 PATH 不會包含 Node 的 bin 目錄。

​
疑難排解

​
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，使其永久生效。

​
相關