0 环境
win11 nvm1.2.2 nodejs22.20
1 安装nodejs和git
1.1 修改git拉取项目方式从ssh变成https
执行: git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"
参考QWen:
User:
(base) PS C:\Users\holdbelief> npm i -g openclaw
npm error code 128
npm error An unknown git error occurred
npm error command git --no-replace-objects ls-remote ssh://git@github.com/whiskeysockets/libsignal-node.git
npm error git@github.com: Permission denied (publickey).
npm error fatal: Could not read from remote repository.
npm error
npm error Please make sure you have the correct access rights
npm error and the repository exists.
npm error A complete log of this run can be found in: C:\Users\holdbelief\AppData\Local\npm-cache\_logs\2026-02-04T02_34_28_273Z-debug-0.log
请帮我分析上面异常的原因
QWen:
你遇到的错误是典型的 npm 安装依赖时因 Git SSH 权限问题失败,具体原因和解决方案如下:
🔍 错误分析
1. 根本原因
- 你要安装的包 openclaw(或其某个依赖)在 package.json 中声明了 GitHub 仓库地址为 SSH 格式:
- "dependencies": {
- "libsignal-node": "git+ssh://git@github.com/whiskeysockets/libsignal-node.git"
- }
- npm 在安装时会调用 Git 命令拉取该仓库:
- git --no-replace-objects ls-remote ssh://git@github.com/whiskeysockets/libsignal-node.git
- 但你的本地 没有配置 GitHub 的 SSH 密钥,导致:
- Permission denied (publickey)
- fatal: Could not read from remote repository.
📌 注意:即使 libsignal-node 是公开仓库,SSH 协议仍要求身份验证(而 HTTPS 不需要)。
✅ 解决方案(推荐两种)
✅ 方案一:全局配置 Git,将 SSH 地址自动转为 HTTPS(最简单,无需配密钥)
运行以下命令,让 Git 自动把所有 ssh://git@github.com/... 替换为 https://github.com/...:
git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"
💡 这样 npm 就会通过 HTTPS 协议 拉取公开仓库,无需 SSH 密钥。
然后重试安装:
npm i -g openclaw
✅ 优点:
- 一行命令解决,永久生效;
- 适用于所有类似问题;
- 不影响已有 SSH 配置。
✅ 方案二:配置 GitHub SSH 密钥(适合长期开发者)
如果你经常使用 Git,建议配置 SSH 密钥:
步骤 1:生成 SSH 密钥(如果还没有)
ssh-keygen -t ed25519 -C "your_email@example.com"
- 一路回车(默认保存到 ~/.ssh/id_ed25519)
步骤 2:将公钥添加到 GitHub
复制公钥内容
Get-Content ~/.ssh/id_ed25519.pub | Set-Clipboard
- 打开 GitHub → Settings → SSH and GPG keys
- 点击 New SSH key,粘贴内容,保存
步骤 3:测试连接
ssh -T git@github.com
- 如果看到 Hi <username>! You've successfully authenticated...,说明成功
步骤 4:重试安装
npm i -g openclaw
⚠️ 其他注意事项
- 不要用 cnpm 或淘宝镜像安装
这类工具可能无法正确处理 Git 依赖,建议使用官方 npm。 - 确认仓库是否存在
访问 https://github.com/whiskeysockets/libsignal-node 确认仓库未被删除或设为私有(目前是公开的)。 - 临时解决方案(不推荐)
如果只是临时安装,可手动 fork 该仓库,改用 HTTPS 地址,但这不适用于全局安装。
🧪 验证是否修复
运行以下命令测试 Git 是否能访问 GitHub:
git ls-remote https://github.com/whiskeysockets/libsignal-node.git HEAD
如果返回 commit hash,说明网络和权限正常。
✅ 总结
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | | 方法 | 适用场景 | 操作 | |--------------------------------|---------------|---------| | git config --global url... | 快速解决,不想配 SSH | 推荐!一行命令 | | 配置 SSH 密钥 | 长期开发,频繁使用 Git | 更安全、高效 | | |
💡对于绝大多数用户,方案一(转 HTTPS)是最简单有效的解决方式。
执行后,你的 npm i -g openclaw 应该就能正常安装了。
2 安装openclaw
执行npm i -g openclaw
3 启动openclaw onboard
3.1 执行 openclas onboard
执行openclas onboard
3.2 忽略风险提示

3.3 Onboarding mode选择QuickStart

3.4 Model/auth provider选择Qwen OAuth

3.5 选择之后会弹出Qwen OAuth认证界面

Model configured, Provider notes, Default model, Channel status, How channels work, Select channel, Configure skills now?, 等等的选择.

3.6 等待web ui的启动

3.7 弹出一个新窗口, 启动服务器

4 浏览器访问
5 配置gateway的token
找到C:\Users\holdbelief\.openclaw\openclaw.json中的gateway的token, 将token配置到overview的Gateway Token项中.

将token配置到overview的Gateway Token项中, 点击Connect按钮, 如果Snapshot显示Connected, 则表示配置成功.

- 对话测试

7 为OpenClaw安装飞书插件
为windows11安装飞书插件比较麻烦.
7.1 官方安装飞书插件方法的失败
官方的命令openclaw channels add在windows上面执行时候抛出下面异常
Downloading @openclaw/feishu...
Error: spawn EINVAL
7.2 下载插件
curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.3.tgz
7.3 安装插件
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| (base) PS C:\Users\holdbelief> openclaw plugins install ./feishu-0.1.3.tgz 🦞 OpenClaw 2026.2.2-3 (9c5941b) --- Give me a workspace and I'll give you fewer tabs, fewer toggles, and more oxygen. Extracting C:\Users\holdbelief\feishu-0.1.3.tgz... Installing to C:\Users\holdbelief\.openclaw\extensions\feishu... Installing plugin dependencies... [openclaw] Failed to start CLI: Error: spawn EINVAL at ChildProcess.spawn (node:internal/child_process:420:11) at spawn (node:child_process:787:9) at runCommandWithTimeout (file:///C:/Users/holdbelief/AppData/Local/nvm/v22.20.0/node_modules/openclaw/dist/exec-BIMFe4XS.js:201:16) at installPluginFromPackageDir (file:///C:/Users/holdbelief/AppData/Local/nvm/v22.20.0/node_modules/openclaw/dist/installs-C5cjVarj.js:143:24) at async installPluginFromArchive (file:///C:/Users/holdbelief/AppData/Local/nvm/v22.20.0/node_modules/openclaw/dist/installs-C5cjVarj.js:218:9) at async installPluginFromPath (file:///C:/Users/holdbelief/AppData/Local/nvm/v22.20.0/node_modules/openclaw/dist/installs-C5cjVarj.js:345:43) at async Command.<anonymous> (file:///C:/Users/holdbelief/AppData/Local/nvm/v22.20.0/node_modules/openclaw/dist/plugins-cli-DAmfi5s-.js:288:19) at async Command.parseAsync (C:\Users\holdbelief\AppData\Local\nvm\v22.20.0\node_modules\openclaw\node_modules\commander\lib\command.js:1122:5) at async runCli (file:///C:/Users/holdbelief/AppData/Local/nvm/v22.20.0/node_modules/openclaw/dist/run-main-CsR44g3a.js:161:2) |
7.4 安装插件的依赖
执行上面的命令会在C:\Users\holdbelief\.openclaw\extensions目录下面创建一个feishu目录, 进入这个目录, 然后执行npm install.

7.5 重启OpenClaw gateway
openclaw gateway restart
8 打开飞书开发者后台
登录
8.1 创建企业自建应用


进去之后有App ID和App Secret, 记录这两个.

8.2 为OpenClaw添加飞书channel
执行下面命令

执行openclaw channels add命令, 选择"Yes"以及"飞书", 然后添加App ID和App Secret



8.3 添加一个机器人应用

8.4 开通群聊的权限

8.5 添加事件回调配置
配置事件回调方式为长连接

9 从飞书上找到创建的应用, 然后发送指令
9.2 手机或者PC版本飞书上面找到创建的应用

9.3 发送指令




从AI的回复可以看到, 它依靠Agent解决了很多问题, 如果有依赖问题则自动添加依赖.