Skip to content
OpenClaw Docs

Node.js

OpenClaw 需要 Node 22.19 或更新版本。Node 24 是安裝、CI 和發行工作流程的預設與推薦執行環境。Node 22 仍透過活躍的 LTS 線路獲得支援。安裝腳本 會自動偵測並安裝 Node——本頁面適用於您想要自行設定 Node 並確保一切配置正確（版本、PATH、全域安裝）的情況。

檢查您的版本

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

如果顯示 v24.x.x 或更高版本，則您處於推薦的預設版本。如果顯示 v22.19.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. 尋找您的全域 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 上發生權限錯誤 (Linux)

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

如果您看到 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 “相關資訊”