npm安装OpenClaw中Git报错解决方法
文章目录
前言
openclaw安装环境：原生win11(未安装WSL2)，node.js 24.12.0(LTS)，npm 11.7.0
一、安装命令
通用npm安装：npm install -g openclaw@latest，安装最新稳定版openclaw
官方安装命令：curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd --tag beta && del install.cmd，安装测试版（beta）
二、缺少依赖工具
报错信息：npm error code ENOENT / syscall spawn git / 找不到Git文件
核心原因：电脑未安装Git工具，npm安装openclaw时需要调用Git拉取源码，命令执行失败
具体操作：
- 打开Git官方下载地址：https://git-scm.com/download/win
- 下载windows版本的Git安装包
- 双击安装，全程默认下一步即可
- 安装过程中，勾选
Git from the command line and also from 3rd-party software，即可自动配置系统环境变量，无需手动设置 - 关闭当前所有终端，重新打开一个新的终端，输入
git --version查看版本号
三、缺少GitHub权限
报错信息：安装Git后执行命令，报错 [email protected]: Permission denied (publickey) / code 128
核心原因：Git默认使用SSH协议访问GitHub，电脑未配置GitHub SSH密钥，无访问权限，所以我们需要强制Git使用HTTPS协议，暂时绕过密钥验证
具体操作：
- 在终端输入
C:\Users\你的用户名称\.gitconfig，按回车，用记事本打开这个文件（如果在终端直接配置会因为Windows PowerShell存在的解析Bug，执行git config命令时，相同域名的配置会自动覆盖，仅最后一条规则生效，SSH协议的替换规则完全丢失） - 回到终端执行
git config --global --get-regexp url，应该输出对应3行规则
继续安装openclaw
npm cache clean --force# 清理缓存npminstall-g openclaw@latest 删掉其中所有内容，粘贴以下配置
[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/ ps：安装时遇到拿不准的步骤可以暂时skip，后续用openclaw onboard命令回来修改
