1. 先看清这个报错到底在说什么npm error code ENOENT搭配npm error syscall spawn git翻译成人话就是npm 在安装 openclaw 的过程中需要调用git这个命令去拉取某个依赖仓库但它在当前环境里找不到可执行的 git 文件。ENOENT 是 Error NO ENTry 的缩写意思是找不到文件或目录而syscall spawn git明确告诉你找不到的那个东西就是 git。openclaw 的部分依赖是以gitssh://或githttps://协议直接引用 GitHub 仓库的比如常见的ssh://gitgithub.com/whiskeysockets/libsignal-node.git这类地址。npm 遇到这种依赖时不会走普通的 tarball 下载而是会 fork 一个子进程去执行git ls-remote、git clone之类的命令。只要系统里没有 git或者 git 装了但不在 PATH 里这个子进程就 spawn 不起来于是整个安装中断。这个报错在 Windows 和 macOS 上都可能出现但触发原因略有差别。Windows 上最常见的是压根没装 Git for Windows或者装的时候没勾选添加到 PATHmacOS 上则可能是 Xcode Command Line Tools 没装或者 Homebrew 装的 git 路径没进 shell 配置。还有一种容易被忽略的情况你在 VS Code 或 Cursor 的集成终端里跑命令终端继承的 PATH 不完整系统终端里能用的 git 在 IDE 终端里就是找不到。这篇内容会按确认问题 → 装好 git → 配好 PATH → 验证 → 接入模型的顺序走一遍每一步都给可复制的命令。装完 openclaw 之后我会顺带说下怎么用 TaoToken 统一管理 Key 和 API 通道让后续的模型调用不用每个工具单独配一遍。2. 装 openclaw 之前先把 git 这条链路打通openclaw 本身是个 Node 生态的 CLI 工具通过npm install -g openclawlatest全局安装。它的安装脚本和依赖树里有多处 git 引用所以 git 不是可选项是硬性前置条件。在动手装 openclaw 之前建议先花两分钟确认 git 这条链路是通的能省掉后面反复卸载重装的麻烦。判断标准很简单打开终端执行git --version如果输出类似git version 2.45.0就说明 git 可用。如果提示command not found或者 Windows 上弹git 不是内部或外部命令那就得先装。注意这里有个坑有些环境下git --version能跑通但 npm 依然报 spawn git原因通常是 npm 运行时的 PATH 和你手动执行命令时的 PATH 不一致这个后面第 5 节会专门讲。关于模型接入这块openclaw 装好之后需要配置模型通道。我习惯用 TaoToken 做统一入口它的 API 地址是https://taotoken.net/api兼容 OpenAI 风格的调用格式一个 Key 可以走多个模型。这样 openclaw 里配一次后面换模型或者加工具都不用重新折腾鉴权。官网在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册后在控制台生成 Key 即可。3. 分平台装 git 并写进环境变量3.1 Windows装 Git for Windows 并确认 PATH去https://git-scm.com/download/win下载安装包安装过程中有一个关键选项页叫 Adjusting your PATH environment务必选Git from the command line and also from 3rd-party software。这个选项会把C:\Program Files\Git\cmd写进系统 PATHnpm 才能找到 git。如果装的时候选了 Use Git from Git Bash only那系统终端和 npm 都看不到 git必然报 ENOENT。装完必须重启终端最好连 IDE 一起关掉重开因为 PATH 是进程启动时读取的老进程不会自动刷新。验证where git # 期望输出: C:\Program Files\Git\cmd\git.exe git --version如果where git没输出说明 PATH 没配上手动补一条管理员权限 PowerShell[Environment]::SetEnvironmentVariable( Path, [Environment]::GetEnvironmentVariable(Path, Machine) ;C:\Program Files\Git\cmd, Machine )执行完关掉当前 PowerShell 重新开一个再跑git --version确认。3.2 macOSHomebrew 或 Xcode CLT 二选一macOS 上如果git --version提示需要安装命令行工具直接xcode-select --install弹窗点安装等它下完即可。如果你已经用 Homebrew也可以brew install gitHomebrew 在 Apple Silicon 上装到/opt/homebrew/bin/gitIntel 机器上是/usr/local/bin/git。确认路径which git如果which git没结果但你知道 git 装在某个目录就往 shell 配置里补 PATH。zsh 是 macOS 默认 shellecho export PATH/opt/homebrew/bin:$PATH ~/.zshrc source ~/.zshrcIntel 机器把路径换成/usr/local/bin。改完重新开终端which git应该能定位到。3.3 Linux / Docker一条命令补齐Ubuntu / Debian 系sudo apt update sudo apt install git -yAlpine 基础镜像Docker 里常见FROM node:20-alpine RUN apk add --no-cache git RUN npm install -g openclawlatestDocker 场景要特别注意apk add git必须写在npm install之前而且要在同一个 RUN 层或者确保镜像层顺序正确否则构建时依然会 spawn git 失败。4. 可复制的 npm 配置与安装命令git 就绪之后先别急着直接装建议把 npm 的几个相关配置确认一遍避免因为 registry 或 git 协议的问题二次踩坑。# 查看当前 registry国内环境建议用镜像加速 npm config get registry # 如果拉取慢可以临时切到国内镜像 npm config set registry https://registry.npmmirror.com # 确认 npm 能找到 git部分版本支持 npm config get git然后执行安装npm install -g openclawlatest如果安装过程中卡在某个 git 依赖上可以加--verbose看详细日志定位是哪个包在调 gitnpm install -g openclawlatest --verbose 21 | grep -i spawn gitWindows PowerShell 里 grep 换成Select-Stringnpm install -g openclawlatest --verbose 21 | Select-String spawn git安装成功后验证openclaw --version能打印版本号就说明 CLI 装好了。接下来是模型接入环节。openclaw 需要配置模型 API我建议用 TaoToken 统一管理避免每个工具单独填 Key。在 TaoToken 控制台生成 API Key 后配置到 openclaw 的环境变量或配置文件里。API 基地址用https://taotoken.net/apiKey 通过控制台获取。如果你打算长期跑编码类任务或者 Agent 工作流可以看下 Coding Plan 的额度方案比按次调用更划算。具体入口在控制台里能找到。5. 验证请求与常见错排查5.1 验证 git 与 npm 的 PATH 是否一致这是最容易翻车的地方。手动git --version能跑npm 却报 spawn git说明 npm 进程的 PATH 和你 shell 的 PATH 不同。用一个 Node 脚本直接打印 npm 看到的 PATHnode -e console.log(process.env.PATH)对比echo $PATHWindows 用$env:Path的输出看 git 所在目录是否在 Node 打印的 PATH 里。如果不在说明你的 shell 配置.zshrc/.bashrc没被 npm 继承或者 IDE 终端用了不同的启动方式。VS Code / Cursor 集成终端的处理办法先关掉 IDE用系统自带终端Windows Terminal / macOS Terminal重新跑安装命令。如果必须在 IDE 里跑可以临时补 PATH# macOS / Linux 在 IDE 终端里 export PATH/opt/homebrew/bin:$PATH npm install -g openclawlatest# Windows 在 IDE 终端里 $env:Path ;C:\Program Files\Git\cmd npm install -g openclawlatest5.2 逐条排查清单现象可能原因处理git --version无输出未安装 git按第 3 节安装where git为空PATH 未配置手动写 PATH 并重启终端手动能跑npm 报错npm 进程 PATH 不同用 node 打印 PATH 对比IDE 终端报错系统终端正常IDE 继承 PATH 不完整关 IDE 重开或临时 exportDocker 构建报错镜像未装 gitDockerfile 里apk add git装完仍报 ssh 相关错gitssh 协议无密钥改用 https 或配 SSH key5.3 模型接入验证openclaw 装好后用一条最小请求验证模型通道是否通。以 TaoToken 的 OpenAI 兼容接口为例curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: ping}] }返回里有choices字段就说明通道正常。如果返回 401检查 Key 是否填对返回 404检查 base URL 是否漏了/v1。openclaw 里配置模型时base URL 填https://taotoken.net/apiKey 填控制台生成的那串。想先在网页上试模型效果可以直接用模型对话页面不用写代码就能验证 Key 和模型是否匹配。接入文档里有各语言的完整示例排障时对着看比较快。6. 把 Key 和通道统一起来后续少折腾装 openclaw 报 spawn git 这件事本质是环境问题不是代码问题装好 git、配好 PATH、重启终端九成情况就解决了。真正值得花时间的是后面模型接入的架构如果你同时用 openclaw、Cursor、Claude Code 这类工具每个都单独配 Key 和 base URL换模型时得改一圈。用 TaoToken 做统一入口的好处是所有工具都指向同一个 API 地址和同一套 Key换模型只改 model 字段鉴权不用动。openclaw 里配好之后后续加新工具也是复制同一份配置。API Key 在控制台生成接入文档里有 openclaw 和其他常见工具的配置模板照着填就行。如果你主要跑编码和 Agent 任务Coding Plan 的额度比按量计费更适合高频调用控制台里能直接看用量。整套流程走下来从 git 报错到模型跑通核心就三件事git 装对、PATH 配对、Key 配一次全局复用。
