OpenClaw 安装指南 使用 npm 快速配置教程

在Windows操作系统上部署OpenClaw，手动安装方式依然是稳定性最高、最受推荐的方案。本指南将为您详细拆解从环境配置到成功验证的完整流程，并提供所有核心组件的官方下载渠道，确保安装过程顺畅无阻。

环境准备

完善的准备工作是成功部署的基础。开始安装前，请务必确认您的Windows系统已配备以下两项关键软件。

安装 Node.js (版本 ≥ 22)

这是运行OpenClaw的强制性前置条件，Node.js版本必须为22或更高。请直接访问Node.js官方网站，下载最新的LTS（长期支持）版本安装包。安装时，请务必勾选“Add to PATH”选项，以便系统在任意命令行位置都能识别Node.js命令。安装完成后，请以管理员身份打开Windows PowerShell，分别执行node -v和npm -v指令，若终端能正确显示版本号，则证明Node.js环境已就绪。

安装 Git (可选但推荐)

虽然Git并非OpenClaw运行的绝对必需项，但部分插件或底层依赖可能会调用Git命令。为避免后续出现不可预见的兼容性问题，我们强烈建议您提前安装。请前往Git官网下载Windows版本安装程序，安装过程中同样注意勾选“Add Git to PATH”选项。

安装步骤

完成环境准备后，即可进入核心的OpenClaw安装阶段。遵循以下步骤能有效规避绝大多数常见错误。

步骤 1：配置国内镜像源

考虑到国内网络访问npm官方仓库可能存在速度缓慢或连接不稳定的情况，建议将npm源切换至国内镜像，例如淘宝NPM镜像，以大幅提升依赖下载成功率。在PowerShell中执行以下配置命令：

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

配置完成后，您可以通过npm config get registry命令进行验证，若返回结果为上述镜像地址，则表明源切换成功。

步骤 2：全局安装 OpenClaw

此步骤有一个重要前提：请务必使用管理员权限启动PowerShell窗口。随后，执行全局安装指令：

npm.cmd install -g openclaw@latest

耐心等待安装进程完成即可。

⚠️ 常见问题处理

若安装过程中遭遇与Git SSH密钥相关的错误提示（例如典型的“Permission denied (publickey)”），这通常是由于Git默认使用SSH协议克隆代码仓库导致的。解决方案是强制将全局Git配置更改为使用HTTPS协议。执行以下命令：

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

此命令执行后，请重新运行一次npm install -g openclaw@latest安装命令，问题通常即可得到解决。

验证安装

如何确认OpenClaw已在您的Windows电脑上成功部署？验证方法非常简单。在PowerShell中键入以下版本查询命令：

openclaw --version

如果终端能够清晰地输出当前安装的OpenClaw版本号，则标志着安装已圆满成功。接下来，您可以执行openclaw onboard命令来启动初始化配置向导，根据引导填入您的大语言模型API密钥等必要信息，即可正式开始使用OpenClaw的各项功能。