English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Install overview

Node.js

OpenClaw 需要 Node 22.16 或更新版本。Node 24 是安裝、CI 與發布工作流程的預設且建議執行環境。Node 22 仍透過現行 LTS 系列受到支援。安裝程式指令碼會自動偵測並安裝 Node - 本頁適用於你想自行設定 Node，並確認所有項目都已正確串接時使用（版本、PATH、全域安裝）。

檢查你的版本

bash
node -v

如果輸出 v24.x.x 或更高版本，表示你使用的是建議的預設版本。如果輸出 v22.16.x 或更高版本，表示你使用的是受支援的 Node 22 LTS 路徑，但我們仍建議在方便時升級到 Node 24。如果尚未安裝 Node，或版本太舊，請從下方選擇一種安裝方式。

安裝 Node

macOS

Homebrew（建議）：

bash
brew install node

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

Linux

Ubuntu / Debian：

bash
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt-get install -y nodejs

Fedora / RHEL：

bash
sudo dnf install nodejs

或使用版本管理器（見下方）。

Windows

winget（建議）：

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey：

powershell
choco install nodejs-lts

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

Using a version manager (nvm, fnm, mise, asdf)

版本管理器可讓你輕鬆切換 Node 版本。常見選項：

  • fnm - 快速、跨平台
  • nvm - 在 macOS/Linux 上廣泛使用
  • mise - 多語言工具（Node、Python、Ruby 等）

使用 fnm 的範例：

bash
fnm install 24fnm use 24

疑難排解

openclaw: command not found

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

  • Find your global npm prefix

    bash
    npm prefix -g

  • Check if it's on your PATH

    bash
    echo "$PATH"

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

  • Add it to your shell startup file

    macOS / Linux

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

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

    然後開啟新的終端機（或在 zsh 中執行 rehash / 在 bash 中執行 hash -r）。

    Windows

    透過「設定」→「系統」→「環境變數」，將 npm prefix -g 的輸出加入系統 PATH。

    • npm install -g 的權限錯誤（Linux）

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

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

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

    相關

    Was this useful?