npm 安装 OpenClaw 遇到 Git 报错的解决方案

环境说明

本次测试基于原生 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 拉取源码时需要调用它，命令执行自然会失败。

解决步骤很简单：

1. 访问 Git 官网 下载 Windows 安装包。
2. 运行安装程序，一路'下一步'即可。
3. 关键一步：安装过程中务必勾选 Git from the command line and also from 3rd-party software，这样会自动配置环境变量，不用手动折腾。
4. 关闭所有终端窗口，重新打开一个，输入 git --version 确认版本已生效。

处理 GitHub 权限问题

装了 Git 后若报 [email protected]: Permission denied (publickey)，通常是 SSH 密钥没配好。在部分网络环境下，强制使用 HTTPS 协议配合镜像源会更稳妥。

注意：Windows PowerShell 下直接执行 git config 有时会有解析 Bug，导致相同域名的配置被覆盖。建议直接编辑配置文件。

1. 找到并打开配置文件：C:\Users\你的用户名称\.gitconfig（用记事本）。
2. 清空原有内容，粘贴以下配置以启用镜像加速：

[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