前言
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
npm install -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 命令回来修改

