前言
OpenClaw 安装环境：原生 Windows 11（未安装 WSL2），Node.js 24.12.0 (LTS)，npm 11.7.0
一、安装命令
通用 npm 安装：
npm install -g openclaw@latest
安装最新稳定版 OpenClaw。
官方安装命令（测试版）：
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd --tag beta && del install.cmd
二、缺少依赖工具
报错信息：npm error code ENOENT / syscall spawn git / 找不到 Git 文件
核心原因：电脑未安装 Git 工具，npm 安装 OpenClaw 时需要调用 Git 拉取源码，命令执行失败。
具体操作：
- 打开 Git 官方下载地址：https://git-scm.com/download/win
- 下载 Windows 版本的 Git 安装包
- 双击安装，全程默认下一步即可
- 安装过程中，勾选
Git from the command line and also from 3rd-party software，即可自动配置系统环境变量，无需手动设置 - 关闭当前所有终端，重新打开一个新的终端，输入
git --version查看版本号
三、缺少 GitHub 权限
报错信息：安装 Git 后执行命令，报错 [email protected]: Permission denied (publickey) / code 128
核心原因：Git 默认使用 SSH 协议访问 GitHub，电脑未配置 GitHub SSH 密钥，无访问权限。我们需要强制 Git 使用 HTTPS 协议，暂时绕过密钥验证。
具体操作：
- 编辑全局 Git 配置文件（路径通常为
%USERPROFILE%\.gitconfig）。如果在终端直接配置会因为 PowerShell 解析问题导致规则覆盖，建议直接用文本编辑器打开该文件。 - 回到终端执行
git config --global --get-regexp url，确认原有规则。 - 删除文件中关于 GitHub 的所有现有 URL 映射规则，粘贴以下配置：
[url "https://gitclone.com/github.com/"]
insteadOf = [email protected]:
insteadOf = ssh://[email protected]/
insteadOf = https://github.com/
完成上述配置后继续安装 OpenClaw：
npm cache clean --force
npm install -g openclaw@latest
注：若安装步骤不确定可跳过，后续使用 openclaw onboard 命令修复。
