文档
安装
Node 版本要求

Node 版本要求

OpenClaw 需要 Node 22+。

如果你使用安装页推荐的安装脚本，脚本会在需要时处理 Node 版本（检测/安装/升级）。 本页用于你想手动安装 Node，并确保版本与 PATH 都正确的场景。

检查版本 

node -v

如果输出是 v22.x.x 或更高版本，就满足要求。

安装 Node.js

macOS

Homebrew（推荐）：

brew install node

或从 https://nodejs.org/ 下载 macOS 安装包。

Linux

Ubuntu / Debian（NodeSource）：

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

建议优先用 WSL2 跑 OpenClaw（更接近 Linux 行为，少踩坑）：https://learn.microsoft.com/windows/wsl/install。

如果你仍希望在 Windows 本机安装 Node：

winget（推荐）：

winget install OpenJS.NodeJS.LTS

Chocolatey：

choco install nodejs-lts

或从 https://nodejs.org/ 下载 Windows 安装包。

使用版本管理器（fnm / nvm / mise / asdf）

版本管理器适合“需要同时维护多个 Node 版本”的开发环境。常见选择：

  • fnm：跨平台、速度快
  • nvm：macOS/Linux 常用
  • mise：多语言版本管理（Node/Python/Ruby 等）

以 fnm 为例：

fnm install 22
fnm use 22

注意：确保版本管理器在你的 shell 启动文件（~/.zshrc / ~/.bashrc）里被初始化。 否则“新开终端”时 PATH 里可能没有 Node/npm，进而导致 openclaw 也找不到。

排障：openclaw: command not found（PATH）

这通常意味着 npm 的全局 bin 目录不在 PATH。

查看 npm 的全局 prefix：

npm prefix -g

检查 PATH：

echo "$PATH"

在 macOS/Linux 上，你需要在 PATH 里能看到 <npm-prefix>/bin。

修复（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）

如果你看到 EACCES，建议把 npm 全局前缀切到用户可写目录：

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

同样，把最后一行 export PATH=... 放进你的 shell 启动文件以永久生效。

NixPodman