跳轉到主要內容
OpenClaw 需要 Node 22.19+、Node 23.11+ 或 Node 24+。Node 24 是安裝、CI 與發布工作流程的預設且建議使用的執行環境；Node 22 仍透過有效的 LTS 版本線提供支援。安裝程式腳本會自動偵測並安裝 Node；當你想自行設定 Node（版本、PATH、全域安裝）時，請使用本頁。

​
檢查你的版本

node -v
建議預設使用 v24.x.x 或更高版本。v22.19.x 或更高版本是受支援的 Node 22 LTS 路徑（方便時請升級到 Node 24）。不支援 v23.11.0 之前的 Node 23 組建。如果缺少 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

找出你的全域 npm prefix

npm prefix -g
2

檢查它是否在你的 PATH 上

echo "$PATH"
在輸出中尋找 <npm-prefix>/bin（macOS/Linux）或 <npm-prefix>（Windows）。
3

將它加入你的 shell 啟動檔

加入到 ~/.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，使其永久生效。

​
相關