Node 运行时

Node.js

OpenClaw 需要 Node 22 或更高版本安装脚本 会自动检测并安装 Node——本页面适用于你希望自行设置 Node 并确保所有配置正确的情况(版本、PATH、全局安装)。

检查版本

node -v

如果输出 v22.x.x 或更高版本,说明一切就绪。如果未安装 Node 或版本过低,请选择下面的安装方式。

安装 Node

brew install node

故障排除

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 启动文件

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

npm install -g 权限错误(Linux)

如果遇到 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 使其永久生效。

诊断标志会话管理深度解析