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