前言

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拉取源码，命令执行失败
具体操作：

1. 打开Git官方下载地址：https://git-scm.com/download/win
2. 下载windows版本的Git安装包
3. 双击安装，全程默认下一步即可
4. 安装过程中，勾选Git from the command line and also from 3rd-party software，即可自动配置系统环境变量，无需手动设置
5. 关闭当前所有终端，重新打开一个新的终端，输入git --version查看版本号

三、缺少GitHub权限

报错信息：安装Git后执行命令，报错 git@github.com: Permission denied (publickey) / code 128
核心原因：Git默认使用SSH协议访问GitHub，电脑未配置GitHub SSH密钥，无访问权限，所以我们需要强制Git使用HTTPS协议，暂时绕过密钥验证
具体操作：

1. 在终端输入C:\Users\你的用户名称\.gitconfig，按回车，用记事本打开这个文件（如果在终端直接配置会因为Windows PowerShell存在的解析Bug，执行git config命令时，相同域名的配置会自动覆盖，仅最后一条规则生效，SSH协议的替换规则完全丢失）

2. 删掉其中所有内容，粘贴以下配置

   [url "https://gitclone.com/github.com/"]
   	insteadOf = git@github.com:
   [url "https://gitclone.com/github.com/"]
   	insteadOf = ssh://git@github.com/
   [url "https://gitclone.com/github.com/"]
   	insteadOf = https://github.com/
   

3. 回到终端执行git config --global --get-regexp url，应该输出对应3行规则
   

4. 继续安装openclaw

   npm cache clean --force  # 清理缓存
   npm install -g openclaw@latest
   

ps：安装时遇到拿不准的步骤可以暂时skip，后续用openclaw onboard命令回来修改