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 使其永久生效。