Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt

Use this file to discover all available pages before exploring further.

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 全局前缀

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 的全局前缀切换到一个用户可写的目录： 
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"
将 export PATH=... 这一行添加到你的 ~/.bashrc 或 ~/.zshrc 中，以使其永久生效。

​
相关内容