Skip to main content

​
Node.js

OpenClaw 需要 Node 22.16 或更新版本。Node 24 是預設且推薦的執行時用於安裝、CI 和發佈工作流。Node 22 透過活躍 LTS 行保持支援。安裝指令碼會自動檢測和安裝 Node — 此頁面供您想自己設定 Node 並確保一切正確連接時使用（版本、PATH、全域安裝）。

​
檢查您的版本

如果顯示 v24.x.x 或更高，您在推薦預設上。如果顯示 v22.16.x 或更高，您在支援的 Node 22 LTS 路徑上，但我們仍建議在方便時升級至 Node 24。如果 Node 未安裝或版本過舊，選擇下面的安裝方式。

​
安裝 Node

Homebrew（推薦）：
或從 nodejs.org 下載 macOS 安裝程式。
版本管理工具讓您輕鬆在 Node 版本間切換。流行選項：
  • fnm — 快速、跨平台
  • nvm — 在 macOS/Linux 上廣泛使用
  • mise — 多語言（Node、Python、Ruby 等）
fnm 範例：
確保您的版本管理工具在 shell 啟動檔案中初始化（~/.zshrc 或 ~/.bashrc）。如果不是，openclaw 可能在新終端會話中找不到，因為 PATH 不包含 Node 的 bin 目錄。

​
故障排除

​
openclaw: command not found

這幾乎總是意味著 npm 的全域 bin 目錄不在您的 PATH 上。
1

找到您的全域 npm 前綴

2

檢查它是否在你的 PATH 上

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

將其新增到你的 shell 啟動檔

新增到 ~/.zshrc 或 ~/.bashrc：
然後開啟新終端（或在 zsh 中執行 rehash / 在 bash 中執行 hash -r）。

​
Linux 上 npm install -g 的權限錯誤

如果你看到 EACCES 錯誤，將 npm 的全域前綴切換到使用者可寫的目錄：
將 export PATH=... 行新增到你的 ~/.bashrc 或 ~/.zshrc 以使其永久生效。