設定 Node.js 環境

搞定開發環境總是最煩人的步驟。有時候你明明安裝了工具，終端機卻告訴你 command not found，或者因為版本太舊導致程式跑不起來。這不是你的問題，通常只是環境變數或版本管理在搗亂，讓我們花幾分鐘把這些基礎打好。

OpenClaw 需要 Node 22 或更高版本。雖然安裝腳本會自動幫你處理，但如果你想手動管理版本、確保 PATH 正確或處理全域安裝，這篇指南就是為你準備的。

需要準備的東西

Node.js 22 或更高版本

快速開始

1. 檢查目前版本

先看看你電腦裡已經有什麼了：

node -v

如果顯示 v22.x.x 或更高，那你就準備好了。如果還沒安裝或版本太舊，請參考下方的安裝方式。

2. 安裝 Node.js

根據你的作業系統選擇最推薦的方式：

macOS:

Homebrew (推薦方案)：

brew install node

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

Linux:

Ubuntu / Debian：

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

Fedora / RHEL：

sudo dnf install nodejs

或者使用下方提到的版本管理工具。

Windows:

winget (推薦方案)：

winget install OpenJS.NodeJS.LTS

Chocolatey：

choco install nodejs-lts

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

3. 使用版本管理工具 (nvm, fnm, mise, asdf)

我強烈建議使用版本管理工具，這能讓你輕鬆切換不同版本：

fnm — 速度極快，跨平台支援
nvm — macOS/Linux 上的經典選擇
mise — 支援多種語言 (Node, Python, Ruby 等)

以 fnm 為例：

fnm install 22
fnm use 22

疑難排解

`openclaw: command not found`

這通常代表 npm 的全域 bin 目錄不在你的 PATH 環境變數中。

1. 找出你的全域 npm 前綴

    npm prefix -g

2. 檢查它是否在 PATH 中

    echo "$PATH"

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

3. 將其加入 shell 設定檔

macOS / Linux:

在 ~/.zshrc 或 ~/.bashrc 加入這行：

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

接著開啟新終端機（或在 zsh 執行 rehash / 在 bash 執行 hash -r）。

Windows:

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

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

如果你看到 EACCES 錯誤，請將 npm 的全域前綴切換到使用者有權限寫入的目錄：

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

記得把 export PATH=... 這行加入你的 ~/.bashrc 或 ~/.zshrc 才能永久生效。

如果你在設定過程中遇到任何奇怪的問題，可以隨時詢問 AI Setup Assistant。

下一步

OpenClaw Expert

還是卡住了？

如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。