Node.js 安装

OpenClaw 需要 Node 22 或更新版本。官方安装脚本会自动检测并安装 Node——本页面适用于你想手动安装 Node，或 openclaw 命令安装后找不到的情况。

---

检查当前版本

node -v

输出 v22.x.x 或更高即可。如果 Node 未安装或版本过低，选择以下安装方式。

---

安装 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 安装器。

提示：Windows 用户强烈推荐使用 WSL2（Ubuntu）运行 OpenClaw，原生 Windows 工具兼容性差。

---

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

版本管理器允许你在多个 Node 版本之间切换，常用工具：

• fnm：快速，跨平台
• nvm：macOS/Linux 主流选择
• mise：多语言（Node、Python、Ruby 等）

以 fnm 为例：

fnm install 22
fnm use 22

警告：确保版本管理器在 shell 启动文件（~/.zshrc 或 ~/.bashrc）中初始化。否则新开终端时 PATH 不包含 Node 的 bin 目录，openclaw 命令会找不到。

---

故障排除

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"
# 将上面这行加入 ~/.bashrc 或 ~/.zshrc

---

安装完成后

参考 安装总览 继续安装 OpenClaw CLI。