安装 Node.js 与 npm

准备与版本选择

Node.js 是多个 CLI 的运行环境，npm 用于安装客户端。先到 Node.js 官方下载选择满足目标客户端要求的 LTS；不要把旧终端中已有的版本当成最新要求。安装环境本身不需要 MonkeyAI 密钥。

OpenClaw 需要 Node 24.x 至少 24.16 或 26.1+，安全版本建议 24.22.1+ / 26.12.1+。请在官方页面选择满足要求的版本；发行版仓库或默认 Homebrew 包不保证满足此要求。

Windows

下载匹配 x64/ARM64 架构的官方安装包，按安装器提示保留 PATH 与 npm 组件，完成后重新打开 PowerShell。已安装 Chocolatey 或 Scoop 的用户，也可选择其中一种方式，不要混装多个来源：

powershell
choco install nodejs-lts
# 或在已配置的 Scoop 中运行：
scoop install nodejs-lts

这些是第三方包管理器命令，不是本站安装脚本。受管理的电脑应使用组织允许的软件源。

macOS

可使用官方 macOS 安装包。已有 Homebrew 时，可运行 brew install node；该公式不保证固定为 LTS，请核对安装版本和客户端要求。Apple Silicon 与 Intel 应选对应架构。安装后重开终端，让 PATH 生效。

Linux

Ubuntu / Debian 可先查询发行版版本，再安装：

bash
apt-cache policy nodejs
sudo apt-get install nodejs npm

RHEL 系发行版先检查可用的软件流或仓库，再按系统版本安装：

bash
dnf info nodejs
sudo dnf install nodejs npm

旧版 CentOS 的仓库可能已经停止维护；若仓库版本不满足要求，使用 Node.js 官方下载页提供的匹配架构发行包及其安装说明。不要为了凑版本直接执行未知远程脚本。npm 全局安装发生权限错误时，优先使用用户拥有的 Node 安装位置，而非对所有命令追加 sudo。

验证与排错

text
node --version
npm --version

两条命令都应输出版本。Windows 用 where.exe node，macOS / Linux 用 command -v node 检查实际路径。若找不到命令，重开终端并检查 PATH；若版本不一致，清理旧安装路径。PowerShell 阻止 npm.ps1 时，可在确认来源后使用 npm.cmd，不必全局降低执行策略。

下一步

选择 Codex、Claude Code 或 Gemini CLI。客户端安装成功后还需要单独设置 MonkeyAI 地址、密钥组和模型。