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