Node.js 安装

OpenClaw 要求 Node 22.16 或更新版本。Node 24 是默认推荐运行时，Node 22 LTS 仍受支持。

检查版本

node -v

• v24.x.x 或更高：推荐默认
• v22.16.x 或更高：支持，建议升级到 Node 24
• 未安装或版本过低：按下方选择安装方式

安装 Node

macOS（推荐 Homebrew）：

brew install node

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

版本管理器

推荐使用版本管理器（fnm、nvm、mise）灵活切换版本：

# fnm 示例
fnm install 24
fnm use 24

注意：确保版本管理器在 shell 启动文件（~/.zshrc 或 ~/.bashrc）中初始化，否则新终端中 openclaw 可能找不到。

常见问题

openclaw: command not found

npm 全局 bin 目录不在 PATH 中：

# 查找全局 npm prefix
npm prefix -g
 
# 添加到 PATH（macOS/Linux）
export PATH="$(npm prefix -g)/bin:$PATH"
# 写入 ~/.zshrc 或 ~/.bashrc 使其永久生效

Linux 上 npm install -g 权限错误（EACCES）

mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"
# 写入 ~/.bashrc 或 ~/.zshrc

相关链接

• install-installer — 安装脚本详解
• install-updating — 更新 OpenClaw