Install overview
Node.js
OpenClaw 需要 Node 22.14 或更新版本。Node 24 是安裝、CI 和發行工作流程的預設且建議使用的執行階段。Node 22 仍透過作用中的 LTS 系列受支援。安裝程式指令碼會自動偵測並安裝 Node - 本頁適用於你想自行設定 Node，並確認所有內容都已正確串接時使用（版本、PATH、全域安裝）。
檢查你的版本
node -v
如果輸出 v24.x.x 或更高版本，表示你使用的是建議的預設版本。如果輸出 v22.14.x 或更高版本，表示你使用的是受支援的 Node 22 LTS 路徑，但我們仍建議在方便時升級到 Node 24。如果尚未安裝 Node，或版本太舊，請從下方選擇一種安裝方式。
安裝 Node
macOS
Homebrew（建議）：
brew install node
或從 nodejs.org 下載 macOS 安裝程式。
Linux
Ubuntu / Debian：
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs
Fedora / RHEL：
sudo dnf install nodejs
或使用版本管理器（見下方）。
Windows
winget（建議）：
winget install OpenJS.NodeJS.LTS
Chocolatey：
choco install nodejs-lts
或從 nodejs.org 下載 Windows 安裝程式。
使用版本管理器（nvm、fnm、mise、asdf）
版本管理器可讓你輕鬆在不同 Node 版本之間切換。常見選項：
fnm 範例：
fnm install 24
fnm use 24
疑難排解
openclaw: command not found
這幾乎總是表示 npm 的全域 bin 目錄不在你的 PATH 中。
尋找你的全域 npm prefix
npm prefix -g
檢查它是否在你的 PATH 中
echo "$PATH"
在輸出中尋找 <npm-prefix>/bin（macOS/Linux）或 <npm-prefix>（Windows）。
將它加入你的 shell 啟動檔
macOS / Linux
加入 ~/.zshrc 或 ~/.bashrc：
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，讓它永久生效。