npm 安装 OpenClaw

千百元2026-04-07 11:02

在 Windows 上使用 npm 安装 OpenClaw，最稳定且推荐的方式是手动安装。以下是详细的步骤和所需资源的官方地址。

📦 环境准备

在开始之前，请确保你的系统已安装以下必要组件。

安装 Node.js (版本 ≥ 22)

OpenClaw 要求 Node.js 版本不低于 22。

官方下载地址： https://nodejs.org/

下载并安装 LTS (长期支持) 版本。安装时，请务必勾选 "Add to PATH" 选项，以便在命令行中直接使用。

安装完成后，打开 PowerShell 输入 node -v 和 npm -v 来验证是否安装成功。

安装 Git (可选但推荐)

某些插件和功能可能需要 Git 支持。

安装时同样建议保持默认选项，确保 "Add Git to PATH" 被勾选。

🛠️ 安装步骤

请严格按照以下步骤操作，可以有效避免常见的安装错误。

步骤 1：配置国内镜像源

由于网络原因，直接通过 npm 官方源安装可能会非常缓慢或失败。建议先切换到国内的淘宝镜像源。

打开 PowerShell，执行以下命令：

bash 复制代码

npm.cmd config set registry https://registry.npmmirror.com/

你可以通过 npm config get registry 来验证是否配置成功，如果返回上面的地址，说明配置已生效。

步骤 2：全局安装 OpenClaw

以管理员身份打开 PowerShell，然后执行全局安装命令：

bash 复制代码

npm.cmd install -g openclaw@latest

⚠️ 常见问题处理

如果在安装过程中遇到 Git SSH 权限报错（例如 Permission denied (publickey)），可以通过以下命令将 Git 拉取协议从 SSH 切换为 HTTPS 来解决：

bash 复制代码

git config --global url."https://github.com/".insteadOf git@github.com:

执行完上述命令后，请重新运行 npm install -g openclaw@latest 命令。

✅ 验证安装

安装完成后，在 PowerShell 中输入以下命令来验证 OpenClaw 是否安装成功：

bash 复制代码

openclaw --version

如果能正确输出版本号，说明安装成功。接下来，你可以通过运行 openclaw onboard 命令来启动配置向导，根据提示完成大模型 API Key 等核心设置。