OpenClaw 是一个开源的 AI 助手框架，支持多种消息渠道接入。最近我从源码编译运行 OpenClaw，并尝试安装微信插件，遇到了不少坑。记录一下完整的安装过程，希望能帮到有类似需求的人。
编辑
环境信息
- 系统： Windows 11 (MINGW64 / Git Bash)
- Node.js： v24.14.0
- OpenClaw： 2026.4.2（源码编译，位于
/e/ai/aicode/traeHome/workHome/openclaw-2026.4.2） - 包管理器： pnpm
第一坑：官方一键安装脚本找不到 openclaw
微信插件官方推荐使用一键安装命令：
npx -y @tencent-weixin/openclaw-weixin-cli install
执行后直接报错：
[openclaw-weixin] 未找到 openclaw，请先安装：
npm install -g openclaw
原因： 我是源码编译运行的 OpenClaw，并没有通过 npm install -g openclaw 全局安装。虽然手动添加了 node 路径到 PATH：
export PATH="/e/ai/aicode/traeHome/workHome/openclaw-main/node-v24.14.0-win-x64:$PATH"
但 CLI 安装脚本查找的是全局安装的 openclaw 命令，源码版本并不在系统 PATH 上。
第二坑：正确的前缀是 pnpm openclaw
既然是源码编译，需要通过 pnpm 来运行 openclaw 命令。一开始试了 pnpm claw，不行：
pnpm claw plugins install @tencent-weixin/openclaw-weixin
# 'claw' 不是内部或外部命令
pnpm 提示了正确的方式：
pnpm openclaw plugins install @tencent-weixin/openclaw-weixin
第三坑：ClawHub 被限流（429 Rate Limit）
用正确的命令执行后，又遇到了新的问题：
Resolving clawhub:@tencent-weixin/openclaw-weixin…
ClawHub /api/v1/packages/%40tencent-weixin%2Fopenclaw-weixin failed (429): Rate limit exceeded
Assertion failed: !(handle's flags & UV_HANDLE_CLOSING)
ClawHub（OpenClaw 的插件注册表）服务端限流了。国内网络访问海外服务器本身就不太稳定，加上可能有人频繁请求，直接 429。
解决办法：切换到国内 npm 镜像
npm config set registry https://registry.npmmirror.com
切换到淘宝 npmmirror 后，再次安装：
pnpm openclaw plugins install @tencent-weixin/openclaw-weixin
成功！🎉
Downloading @tencent-weixin/openclaw-weixin…
Installing to C:\Users\conca.openclaw\extensions\openclaw-weixin…
Installed plugin: openclaw-weixin
完成安装：启用 + 扫码登录
插件安装成功后，还需要两步：
1. 启用插件
pnpm openclaw config set plugins.entries.openclaw-weixin.enabled true
pnpm openclaw gateway restart
2. 微信扫码登录
pnpm openclaw channels login --channel openclaw-weixin
终端会显示一个二维码，用微信扫码确认即可：
✅ 与微信连接成功！
登录凭证会自动保存到本地配置中，后续重启 gateway 后会自动连接。
3.安装之后配置文件增加微信插件
"plugins": {
"entries": {
"openclaw-weixin": {
"enabled": true
}
},
"installs": {
"openclaw-weixin": {
"source": "npm",
"spec": "@tencent-weixin/openclaw-weixin",
"installPath": "C:\Users\conca\.openclaw\extensions\openclaw-weixin",
"version": "2.1.6",
"resolvedName": "@tencent-weixin/openclaw-weixin",
"resolvedVersion": "2.1.6",
"resolvedSpec": "@tencent-weixin/openclaw-weixin@2.1.6",
"integrity": "sha512-EEnSZBU+NysjEJ3ur7JHYnvy2q3pvHcfHZVV/jkUrUG0zQuOpuIK2bs7Fi8We/zZ+FWVA+xewqu4mzDs7EUQ==",
"shasum": "c177c98f1c2ccd3fd83dd0979287bc780f5b15",
"resolvedAt": "2026-04-04T13:25:42.868Z",
"installedAt": "2026-04-04T13:26:02.069Z"
}
}
},
"channels": {
"openclaw-weixin": {
"channelConfigUpdatedAt": "2026-04-05T10:34:49.792Z"
}
}
微信账号信息位置C:\Users\conca.openclaw\openclaw-weixin\accounts
编辑
总结
对于源码编译安装的 OpenClaw，微信插件的安装流程如下：
# 1. 确保使用国内镜像
npm config set registry https://registry.npmmirror.com
# 2. 安装微信插件（用 pnpm openclaw 前缀）
pnpm openclaw plugins install @tencent-weixin/openclaw-weixin
# 3. 启用插件
pnpm openclaw config set plugins.entries.openclaw-weixin.enabled true
# 4. 扫码登录
pnpm openclaw channels login --channel openclaw-weixin
# 5. 重启 gateway
pnpm openclaw gateway restart
核心教训：
- 源码编译版需要用
pnpm openclaw来替代全局的openclaw命令 - 国内用户建议提前切换 npm 镜像，避免 ClawHub 注册表限流
- 官方一键安装脚本不适用于源码编译场景
参考链接
- OpenClaw 微信插件 (npm): www.npmjs.com/package/@te…
- OpenClaw 官方文档: docs.openclaw.ai
