环境说明
原生 Win11（未装 WSL2），Node.js 24.12.0 (LTS)，npm 11.7.0。
安装命令
通用安装最新稳定版：
npm install -g openclaw@latest
官方安装测试版（Beta）：
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd --tag beta && del install.cmd
常见问题排查
1. 找不到 Git 文件
如果终端提示 npm error code ENOENT / syscall spawn git，说明系统里还没装 Git。OpenClaw 依赖 Git 拉取源码，必须补上这个工具。
解决步骤：
- 访问 Git 官网下载 Windows 安装包。
- 运行安装程序，一路默认下一步即可。
- 关键一步：安装向导中务必勾选
Git from the command line and also from 3rd-party software，这样环境变量会自动配置好。 - 关闭所有终端窗口重新打开，输入
git --version确认版本已生效。
2. GitHub 权限被拒
装完 Git 后若报 Permission denied (publickey) 或 code 128，是因为 Git 默认用 SSH 连 GitHub，但本地没配密钥。这时候可以强制 Git 走 HTTPS 协议绕过验证。
修改配置：
用文本编辑器打开用户目录下的 .gitconfig 文件（路径通常是 %USERPROFILE%\.gitconfig）。找到里面关于 URL 的配置部分，删掉原有的内容，替换成下面这段，让请求通过镜像源转发：
[url "https://gitclone.com/github.com/"]
insteadOf = [email protected]:
[url "https://gitclone.com/github.com/"]
insteadOf = ssh://[email protected]/
[url "https://gitclone.com/github.com/"]
insteadOf = https://github.com/
注意：直接在 PowerShell 里执行 git config 命令可能会因为解析 Bug 导致规则覆盖丢失，建议手动编辑配置文件更稳妥。
最后安装
清理一下 npm 缓存，再跑一遍安装命令：
npm cache clean --force
npm install -g openclaw@latest
如果中途遇到拿不准的步骤可以先跳过，后续用 openclaw onboard 命令回来补全配置。
