2024年OpenClaw安装指南：新手必看的npm命令详解
对于Windows用户，手动部署OpenClaw是确保稳定性和控制力的首选方案。本指南将详细拆解从环境配置到最终验证的每一步，并提供所有核心组件的官方下载路径。
环境准备
在开始安装前，请先配置好以下两个基础运行环境。
安装 Node.js (版本 ≥ 22)
OpenClaw强制要求Node.js版本不低于22。请访问Node.js官方网站，下载最新的LTS版本进行安装。安装向导中，务必勾选“Add to PATH”选项，以便系统全局识别。安装完成后，启动PowerShell，依次执行node -v和npm -v命令，成功返回版本号即表示环境就绪。
安装 Git (可选但推荐)
尽管并非强制，但部分依赖项可能需要Git支持。为避免后续潜在的兼容性问题，建议预先安装。从Git官网获取Windows安装包，在安装过程中同样确认勾选“Add Git to PATH”。
安装步骤
遵循以下流程执行安装，可规避绝大多数常见错误。
步骤 1：配置国内镜像源
直接访问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 CLI是否已正确部署。在PowerShell中输入版本查询命令：
openclaw --version终端若成功显示当前安装的OpenClaw版本号，则表明核心安装步骤已全部完成。此时，你可以执行openclaw onboard命令来启动初始化向导，根据提示配置你的大模型API密钥等必要参数，即可开始使用。