跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

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

OpenClaw 要求使用 Node 22.16 或更新版本。Node 24 是安装、CI 和发布工作流的默认且推荐的运行时。Node 22 仍通过 active LTS 系列受支持。安装脚本会自动检测并安装 Node - 本页适用于你想自行设置 Node，并确保所有内容正确连接时（版本、PATH、全局安装）。

​
检查你的版本

node -v
如果输出 v24.x.x 或更高版本，说明你正在使用推荐的默认版本。如果输出 v22.16.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

Find your global npm prefix

npm prefix -g
2

Check if it's on your PATH

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

Add it to your shell startup file

添加到 ~/.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，使其永久生效。

​
相关内容