Skip to content
OpenClaw Docs

Node.js

Node.js

Section titled “Node.js”

OpenClaw 需要 Node 22.14 或更新版本。Node 24 是安裝、CI 和發佈工作流程的預設且推薦的運行時。Node 22 透過現有的 LTS 線持續獲得支援。安裝程式腳本 會自動偵測並安裝 Node —— 本頁面適用於您想要自行設定 Node 並確保一切連線正確（版本、PATH、全域安裝）的情況。

檢查您的版本

Section titled “檢查您的版本”
Terminal window
node -v

如果此處顯示 v24.x.x 或更高版本，表示您使用的是推薦的預設版本。如果顯示 v22.14.x 或更高版本，表示您位於受支援的 Node 22 LTS 路徑上，但我們仍建議您在方便時升級至 Node 24。如果尚未安裝 Node 或版本過舊，請從下方選擇一種安裝方式。

安裝 Node

Section titled “安裝 Node”

Homebrew (推薦):

Terminal window
brew install node

或從 nodejs.org 下載 macOS 安裝程式。

使用版本管理器 (nvm, fnm, mise, asdf)

版本管理器讓您輕鬆切換 Node 版本。熱門選項:

  • fnm — 快速、跨平台
  • nvm — 廣泛用於 macOS/Linux
  • mise — 多語言 (Node, Python, Ruby 等)

fnm 範例:

Terminal window
fnm install 24
fnm use 24

疑難排解

Section titled “疑難排解”

openclaw: command not found

Section titled “openclaw: command not found”

這幾乎總是表示 npm 的全域 bin 目錄不在您的 PATH 中。

  1. Find your global npm prefix

    Terminal window
    npm prefix -g

  2. 檢查是否在您的 PATH 中

    Terminal window
    echo "$PATH"

    在輸出中尋找 `

    /bin(macOS/Linux) 或

    ` (Windows)。

  3. 將其加入您的 shell 啟動檔案

    加入到 ~/.zshrc 或 ~/.bashrc：

    Terminal window
    export PATH="$(npm prefix -g)/bin:$PATH"

    然後開啟一個新的終端機 (或在 zsh 中執行 rehash / 在 bash 中執行 hash -r)。

在 npm install -g 上發生權限錯誤

Section titled “在 npm install -g 上發生權限錯誤”

如果您看到 EACCES 錯誤，請將 npm 的全域 prefix 切換到使用者可寫入的目錄：

Terminal window
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

將 export PATH=... 這一行加入到您的 ~/.bashrc 或 ~/.zshrc 以使其永久生效。

相關

Section titled “相關”