环境说明
本次测试基于原生 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
