Node.js

OpenClaw 需要 Node 22.14 或更高版本。Node 24 是默认推荐的运行时，适用于安装、CI 和发布工作流。Node 22 通过活跃 LTS 线路继续受支持。安装脚本会自动检测并安装 Node——本页面适合那些想手动配置 Node 并确保一切正确接通（版本、PATH、全局安装）的用户。

检查当前版本

node -v

如果输出 v24.x.x 或更高，说明你在推荐的默认版本上。如果输出 v22.14.x 或更高，你在受支持的 Node 22 LTS 路径上，但仍建议在方便时升级到 Node 24。如果 Node 未安装或版本过旧，从下面选一种安装方式。

安装 Node

macOS（推荐用 Homebrew）：

brew install node

或者从 nodejs.org 下载 macOS 安装包。

Linux（Ubuntu / Debian）：

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

Linux（Fedora / RHEL）：

sudo dnf install nodejs

也可以使用版本管理器（见下文）。

Windows（推荐用 winget）：

winget install OpenJS.NodeJS.LTS

或用 Chocolatey：

choco install nodejs-lts

也可以从 nodejs.org 下载 Windows 安装包。

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

版本管理器让你轻松切换不同 Node 版本。常用选项：

• fnm — 快速、跨平台
• nvm — macOS/Linux 上广泛使用
• mise — 多语言支持（Node、Python、Ruby 等）

以 fnm 为例：

fnm install 24
fnm use 24

注意：确保版本管理器在 shell 启动文件（~/.zshrc 或 ~/.bashrc）中完成初始化。否则，在新终端会话中可能找不到 openclaw 命令，因为 PATH 里没有 Node 的 bin 目录。

常见问题排查

openclaw: command not found

这几乎总是因为 npm 的全局 bin 目录没有加入 PATH。

第一步：找到全局 npm prefix：

npm prefix -g

第二步：检查它是否在 PATH 里：

echo "$PATH"

查看输出中是否有 <npm-prefix>/bin（macOS/Linux）或 <npm-prefix>（Windows）。

第三步：添加到 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 全局 prefix 改到用户可写目录：

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

在 ~/.bashrc 或 ~/.zshrc 里加上 export PATH=... 这行，让配置永久生效。