Node 运行时
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
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 示例：
fnm install 24
fnm use 24
故障排除
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
通过 Settings → System → Environment Variables，将 npm prefix -g 的输出添加到你的系统 PATH。
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，使其永久生效。