环境说明
本次测试基于原生 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
缺少 Git 依赖工具
如果终端提示 npm error code ENOENT / syscall spawn git / 找不到 Git 文件,说明系统里没装 Git。npm 拉取源码时需要调用它,命令执行自然会失败。
解决步骤很简单:
- 访问 Git 官网 下载 Windows 安装包。
- 运行安装程序,一路'下一步'即可。
- 关键一步:安装过程中务必勾选
Git from the command line and also from 3rd-party software,这样会自动配置环境变量,不用手动折腾。 - 关闭所有终端窗口,重新打开一个,输入
git --version确认版本已生效。
处理 GitHub 权限问题
装了 Git 后若报 [email protected]: Permission denied (publickey),通常是 SSH 密钥没配好。在部分网络环境下,强制使用 HTTPS 协议配合镜像源会更稳妥。
注意:Windows PowerShell 下直接执行 git config 有时会有解析 Bug,导致相同域名的配置被覆盖。建议直接编辑配置文件。
- 找到并打开配置文件:
C:\Users\你的用户名称\.gitconfig(用记事本)。 - 清空原有内容,粘贴以下配置以启用镜像加速:
[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/
保存后继续安装。如果遇到拿不准的步骤,可以先跳过,后续通过 openclaw onboard 命令回来修改。
最后清理缓存并重新安装:
npm cache clean --force
npm install -g openclaw@latest

