Skip to main content

​
Node.js

OpenClaw 需要 Node 22 或更高版本。安装脚本 会自动检测并安装 Node —— 本页适用于您希望自行安装 Node 并确保一切配置正确（版本、PATH、全局安装）时的情况。

​
检查您的版本

node -v
如果输出 v22.x.x 或更高版本，说明符合要求。如果未安装 Node 或版本太旧，请从下方选择安装方法。

​
安装 Node

Homebrew（推荐）：
brew install node
或从 nodejs.org 下载 macOS 安装包。
版本管理器让您可以轻松切换 Node 版本。流行选项包括：
  • fnm — 快速，跨平台
  • nvm — macOS/Linux 上广泛使用
  • mise — 多语言支持（Node、Python、Ruby 等）
以 fnm 为例：
fnm install 22
fnm use 22
确保您的版本管理器在 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 以实现永久生效。