环境说明
原生 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 命令回来补全配置。

