OpenClaw 对接 QQ、企业微信和个人微信

知识点

1. 通过 QQ 开放平台官方方式接入 QQ 机器人（3 条命令搞定）
2. 通过企业微信官方一键接入，扫码即用 OpenClaw
3. 通过企业微信自建应用 + 微信插件，在个人微信中使用 OpenClaw
4. 了解三种方案的优缺点和适用场景

参考来源

• QQ 官方接入：QQ 开放平台 OpenClaw 入口 + CSDN 博主 bhl120 教程
• 微信接入：企业微信官方 OpenClaw 接入页面

一、方案概览

先说清楚：QQ 和微信的接入方式完全不同。

平台	方案	难度	需要公网服务器	能进群吗
QQ 机器人（官方）	QQ 开放平台 + 官方插件	简单，3 条命令	不需要	群聊需 @机器人
微信	企业微信官方一键接入	简单，扫码即用	不需要	不能进群，只能单聊

两个平台现在都有官方支持，接入都很简单。QQ 适合日常聊天场景，企业微信适合办公场景。

二、前置条件

• OpenClaw 已安装并能正常工作（参考第1集）
• OpenClaw 版本 ≥ 2026.2.26
• Gateway 正在运行

openclaw -v
openclaw gateway status

上篇：接入 QQ 机器人

三、QQ 机器人接入（官方方案）

腾讯在 QQ 开放平台专门做了 OpenClaw 的接入入口，整个流程非常简单。

3.1 打开 QQ 开放平台

浏览器访问：https://q.qq.com

用你的 QQ 号登录，进入「应用管理」。

2026 年 3 月起，QQ 开放平台新增了专门的 OpenClaw 入口，不再需要手动配置 IP 白名单。

3.2 创建 QQ 机器人

1. 点击「创建机器人」
2. 填写应用名称（比如 我的AI助手）
3. 提交后获取 AppID 和 AppSecret

3.3 三条命令搞定

回到终端，依次执行：

# 1. 安装 QQ 机器人插件
openclaw plugins install @tencent-connect/openclaw-qqbot@latest

# 2. 添加 QQ 渠道（token 格式：AppID:AppSecret）
openclaw channels add --channel qqbot --token "你的AppID:你的AppSecret"

# 3. 重启 Gateway
openclaw gateway restart

没了，就这三条。

来源：QQ 开放平台 OpenClaw 官方入口，命令也是平台自动生成的。

报错

npm install failed

问题核心原因

1. OpenClaw 内置安装机制的「过度限制」

OpenClaw 的 plugins install 命令不是简单调用 npm install，而是加了多层校验：

• 检测插件代码中的 child_process（Shell 执行）、环境变量读取等行为，即使是插件正常功能，也会触发「安全拦截」；
• 内置的 npm 执行环境被限制了权限 / 超时时间，一旦依赖下载稍慢或编译耗时，就会直接判定「npm install failed」；
• 临时目录（/tmp/openclaw-plugin-*）的权限 / 生命周期管控严格，手动操作稍慢就会被自动清理。

2. 服务器基础环境不匹配

• Node.js 版本：插件要求 node >=24，openclaw安装脚本安装的默认版本是 v22.22.1，部分依赖编译会出现问题；
• 编译依赖缺失：插件中的音频转换、系统调用类依赖需要 gcc/g++/python，即使安装了基础编译环境，低版本系统仍可能编译失败；
• 资源不足：服务器内存 / CPU 不足时，npm install 会因资源抢占卡住，表现为「无报错但一直卡」。

3. 网络层的隐性问题

• npm 源的「安全审计接口」在国内镜像（如淘宝源）未实现，触发 404 警告，OpenClaw 会误判为安装失败；
• 依赖包分片下载时，服务器网络波动导致超时，npm 无重试机制，直接终止安装；
• 部分依赖包（如二进制预编译包）的 CDN 节点在境外，下载速度极慢甚至超时。

分步解决方案

1.升级node版本

如果升级不成功请问Ai

# 全局安装 n 工具
npm install -g n

# 如果提示权限不足（Permission denied），加 sudo 执行
sudo npm install -g n

# 安装并切换到 v24 最新稳定版
sudo n 24

# 查看 Node.js 版本（输出 v24.x.x 即为成功）
node -v

# 查看 npm 版本（同步升级，无需单独操作）
npm -v

2.将npm源改成官方源

国内镜像会出现更新不同步的问题

npm config set registry https://registry.npmjs.org/

3.直接通过npm安装插件

绕过OpenClaw 插件安装机制的限制

npm install -g @tencent-connect/openclaw-qqbot@latest

等待安装好之后把 npm 安装好的包迁移到 OpenClaw 插件目录

4.定位插件安装路径

# 1. 自动定位 npm 全局安装的插件路径（兼容不同系统）
PLUGIN_PATH=$(npm root -g)/@tencent-connect/openclaw-qqbot

# 2. 验证路径是否存在（不存在则提示错误）
if [ ! -d "$PLUGIN_PATH" ]; then
  echo "❌ 插件安装失败，请检查 npm install 命令是否执行成功"
  exit 1
else
  echo "✅ 插件安装路径：$PLUGIN_PATH"
fi

5.迁移到 OpenClaw 插件目录

# 1. 删除 OpenClaw 旧的未完成目录
rm -rf ~/.openclaw/extensions/openclaw-qqbot

# 2. 将 npm 安装好的插件完整复制过去
cp -r $PLUGIN_PATH ~/.openclaw/extensions/openclaw-qqbot

# 3. 赋予正确权限
sudo chown -R muyang:staff ~/.openclaw/extensions/openclaw-qqbot
sudo chmod -R 755 ~/.openclaw/extensions/openclaw-qqbot

6.配置信任 & 验证插件

# 1. 配置 plugins.allow 消除安全提示
jq '.plugins.allow += ["openclaw-qqbot"]' ~/.openclaw/openclaw.json > /tmp/openclaw.tmp && mv /tmp/openclaw.tmp ~/.openclaw/openclaw.json

jq '.plugins.entries["openclaw-qqbot"] = {"enabled": true}' ~/.openclaw/openclaw.json > /tmp/openclaw.tmp && mv /tmp/openclaw.tmp ~/.openclaw/openclaw.json


# 2.重启OpenClaw服务
openclaw gateway restart

# 2. 最终验证（看到插件名称即为成功）
openclaw plugins list | grep openclaw-qqbot

如果系统没装 jq，先 brew install jq。

然后重新配置就OK了

下篇：接入企业微信（微信）

四、企业微信接入方案说明

2026 年 3 月，企业微信也推出了官方 OpenClaw 接入方式，跟飞书和 QQ 一样简单——扫码即用。

来源：企业微信官方 OpenClaw 接入页面

4.1 两种部署场景

场景	说明	适合谁
本地部署	OpenClaw 跑在你自己电脑上	个人开发者，对数据敏感
云服务器部署	OpenClaw 跑在云服务器上	需要 7×24 小时在线

本地部署也能用，企业微信官方插件走的是长连接，不需要公网 IP。

4.2 为什么不用第三方微信协议？

市面上有些方案通过 iPad 协议、Web 协议等方式接入个人微信，这些方案：

• 违反微信使用条款，有封号风险
• 只能用小号，不敢用大号
• 稳定性差，随时可能失效

企业微信方案是在微信生态内合法合规的方式，可以放心用大号。

五、企业微信一键接入（官方方案）

5.1 一条命令安装

npx -y @wecom/wecom-openclaw-cli install

一定要先注册企业微信并且有个企业后再操作

5.2 扫码创建机器人

执行后终端会显示二维码，用企业微信扫码：

1. 选择「扫码接入」
2. 用企业微信扫描二维码
3. 点击「一键创建智能机器人」
4. 创建成功后，点击「前往使用」

就这样，直接在企业微信里就能跟 AI 对话了。

5.3 重启 Gateway

openclaw gateway restart

5.4 验证

在企业微信中找到刚创建的机器人，发一条消息测试。

六、企业微信使用文档能力（可选）

企业微信官方插件还支持操作文档和智能表格。

6.1 升级插件

确保用的是最新版插件：

openclaw plugins update wecom-openclaw-plugin

6.2 授权文档权限

在企业微信中直接对机器人说：

帮我搜集本周零售行业重要新闻，汇总成一篇企业微信文档

机器人会自动发送授权链接，点击「确认授权」后，告诉机器人「授权了」，它就能直接创建和操作企业微信文档了。

6.3 手动授权（备选）

1. 企业微信工作台 → 智能机器人 → 找到你的机器人 → 编辑 → 可使用权限
2. 点击授权，复制 JSON Config
3. 把复制的配置发送给机器人，即可完成安装

七、测试对话

7.1 在企业微信中测试

打开企业微信，找到你的机器人，发一条消息：

你好，介绍一下你自己

AI 正常回复就说明接入成功。

7.2 企业微信方案的特点

• 官方支持，扫码即用，不需要手动配置凭证
• 支持长连接，本地部署也能用（不需要公网 IP）
• 支持操作企业微信文档和智能表格

十、常见问题排查

QQ 相关

Q：安装插件报错 npm ERR

换源后重试：

export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com
openclaw plugins install @tencent-connect/openclaw-qqbot@latest

Q：旧教程说要配 IP 白名单？

那是 2026 年 3 月之前的旧方案，用的是社区插件 @sliverp/qqbot。现在用腾讯官方插件 @tencent-connect/openclaw-qqbot 不需要白名单了。

微信（企业微信）相关

Q：扫码后提示「未找到 Gateway 连接」？

确认 Gateway 正在运行：

openclaw gateway status
openclaw gateway restart

Q：企业微信里找不到机器人？

扫码创建成功后，在企业微信工作台中查找。如果看不到，尝试退出企业微信重新登录。

Q：发消息没反应？

1. 检查 Gateway 日志：openclaw gateway --verbose
2. 跑诊断：openclaw doctor
3. 确认插件已正确安装：openclaw plugins list

Q：能在个人微信里用吗？

不能直接在个人微信里用。企业微信方案是在企业微信内使用，这是目前唯一合规的方式。

十一、本集小结

这一集接入了两个国民级平台：

1. QQ 机器人 — 3 条命令搞定，腾讯官方插件，不需要公网服务器，最简单
2. 微信 — 企业微信官方一键接入，扫码即用，合规安全，不需要公网服务器

QQ 核心命令：

openclaw plugins install @tencent-connect/openclaw-qqbot@latest
openclaw channels add --channel qqbot --token "AppID:AppSecret"
openclaw gateway restart

微信核心命令：

npx -y @wecom/wecom-openclaw-cli install
openclaw gateway restart

加上第2集的飞书，你的 AI 助手现在已经能在飞书、QQ、微信三个平台上工作了。

附录：三平台对比

对比项	飞书	QQ	微信
接入难度	中等	简单	简单
需要公网服务器	不需要	不需要	不需要
官方插件	飞书官方出品	腾讯官方出品	企业微信官方出品
群聊支持	支持	支持（需@）	不支持
办公集成	文档/日历/任务	无	文档/智能表格
适合场景	办公协作	日常聊天	企业办公

附录：命令速查

命令	说明
`openclaw plugins install @tencent-connect/openclaw-qqbot@latest`	安装 QQ 插件
`openclaw channels add --channel qqbot --token "ID:Secret"`	添加 QQ 渠道
`npx -y @wecom/wecom-openclaw-cli install`	安装企业微信插件
`openclaw gateway restart`	重启 Gateway
`openclaw doctor`	诊断问题
`openclaw pairing approve qqbot <code> --notify`	批准 QQ 配对

番外：想在个人微信里用？（自建应用方案）

上面的企业微信官方方案是在企业微信 App 内使用。如果你想在个人微信里也能跟 AI 对话，可以通过「企业微信自建应用 + 微信插件」实现。

核心思路

企业微信有个「微信插件」功能，绑定后个人微信里会出现一个入口，可以直接跟企业微信里的应用对话。

前置条件

• 需要一台公网可访问的服务器（企业微信回调需要公网 IP）
• 企业微信账号（个人注册的企业也行）

大致步骤

1. 安装社区插件 @openclaw-china/wecom-app
2. 在企业微信后台创建自建应用，获取 6 个凭证（corpId、corpSecret、agentId、token、encodingAESKey、webhookPath）
3. 配置 OpenClaw 的 channels.wecom-app，填入凭证
4. 配置接收消息服务器的回调 URL（格式：http://你的公网IP:18789/wecom-app）
5. 配置 IP 白名单
6. 重启 Gateway，在企业微信后台保存配置验证
7. 在企业微信后台「我的企业」→「微信插件」→ 用个人微信扫码关注，即可在个人微信中使用

安装命令

openclaw plugins install @openclaw-china/wecom-app
openclaw china setup
openclaw config set gateway.bind lan

这个方案配置较复杂，且只支持私聊不支持群聊。如果不需要在个人微信里用，推荐用上面的企业微信官方方案。
完整教程参考：BytePioneer-AI/openclaw-china 企业微信自建应用配置指南

本集教程基于 OpenClaw v2026.3.13 编写
QQ 部分参考：CSDN 博主 bhl120
微信部分参考：企业微信官方 OpenClaw 接入页面
个人微信方案参考：BytePioneer-AI/openclaw-china