跳转到主要内容
OpenClaw 需要 Node 22.19+、Node 23.11+ 或 Node 24+。Node 24 是安装、CI 和发布工作流的默认且推荐运行时；Node 22 仍通过活跃 LTS 线获得支持。安装脚本会自动检测并安装 Node；当你想自行设置 Node（版本、PATH、全局安装）时，请使用本页。

​
检查你的版本

node -v
推荐默认使用 v24.x.x 或更高版本。v22.19.x 或更高版本是受支持的 Node 22 LTS 路径（方便时请升级到 Node 24）。不支持 v23.11.0 之前的 Node 23 构建。如果缺少 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，使其永久生效。

​
相关