跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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，讓設定永久生效。

​
相關