跳转到主要内容

​
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

Homebrew（推荐）：
brew install node
或从 nodejs.org 下载 macOS 安装程序。
版本管理器可让你轻松切换不同的 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 中。
1

找到你的全局 npm prefix

npm prefix -g
2

检查它是否在你的 PATH 中

echo "$PATH"
在输出中查找 <npm-prefix>/bin（macOS/Linux）或 <npm-prefix>（Windows）。
3

将它添加到你的 shell 启动文件中

添加到 ~/.zshrc 或 ~/.bashrc：
export PATH="$(npm prefix -g)/bin:$PATH"
然后打开一个新终端（或在 zsh 中运行 rehash，在 bash 中运行 hash -r）。

​
npm install -g 权限错误（Linux）

如果你看到 EACCES 错误，请将 npm 的全局 prefix 切换到一个用户可写目录： 
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"
将 export PATH=... 这一行添加到你的 ~/.bashrc 或 ~/.zshrc 中，以便永久生效。

​
相关内容