微信、QQ 与元宝：腾讯系渠道接入

💡 一句话总结：用 OpenClaw 把 AI 助手带进腾讯系聊天工具 —— 微信扫码私聊、QQ 官方 Bot 进群、元宝 appKey 直连。

办公路线第三课。前两课配好了企业微信和飞书，这一课讲 OpenClaw 接入微信、QQ 与元宝——把剩下的腾讯系渠道补齐。OpenClaw 微信接入靠腾讯微信团队维护的外部插件 openclaw-weixin，个人微信扫码就能用；QQ 走官方开放平台机器人（@tencent-connect/openclaw-qqbot）；元宝由腾讯元宝团队维护、走 WebSocket 连接。三个渠道共用一个 Gateway，互不干扰。全部示例基于 OpenClaw v2026.10.9。

学完你能做什么

用手机微信扫码登录，把 AI 助手接进个人微信私聊——文字、图片等媒体直接处理，不用注册公众号
在 q.qq.com 创建 QQ 机器人，一条命令接进 OpenClaw：C2C 私聊 + 群里 @ 提问，图片/语音/视频/文件都支持
把元宝 Bot 用 appKey:appSecret 配好，元宝私聊和群聊都有人值守
按渠道选对收紧办法：QQ 白名单、元宝配对码、微信扫码自用

为什么用 OpenClaw，而不是网页版 AI？

能力	网页版 AI	OpenClaw + 腾讯系插件
出现的位置	❌ 单开网页，聊天工具里用不了	✅ 微信私聊、QQ、元宝里说话就行
个人微信	❌ 进不了微信，只能复制粘贴	✅ `openclaw-weixin` 扫码登录，微信里直接聊
QQ 群	❌ 群里没有它	✅ 官方 QQ Bot API，群里 @ 就回，富媒体通吃
主动找你	❌ 只能你先问它	✅ 定时任务把早报推进 QQ / 元宝会话
数据与模型	❌ 对话全在服务商手里	✅ Gateway 跑在自己机器上，模型随便换（含国产模型）

你现在的困境

微信是国民工具，可网页版 AI 进不去——每次都要切出去、复制、粘贴、再复制回来
想在 QQ 群里放个 AI 值班，搜一圈全是来路不明的第三方机器人，不敢把聊天记录交给它
在元宝里建了 Bot，想让它接上你自己的 OpenClaw 能力：记忆、技能、自动化全套

什么时候用这一招

当你需要：

AI 出现在个人微信私聊里，手机上随手问——家人朋友都在的地方，它也在
QQ 群里有个能 @ 的机器人，群友的问题它来答
元宝里的 Bot 背后接你自选的模型和全套 OpenClaw 工作流

而且不想：

每次切浏览器复制粘贴
把聊天记录托给来路不明的第三方机器人
自己从零写微信或 QQ 的协议对接

🎒 开始前的准备

走完了场景实战：选择你的路线：Gateway 正在运行、至少连上一个模型
openclaw --version 显示 2026.5.12 以上（微信插件 2.4.8 声明的要求；元宝渠道要求 2026.4.10+；本教程基准 v2026.10.9 满足）
一部装着微信的手机（扫码登录用）；要接 QQ，准备一个能登录 QQ 开放平台的 QQ 号；要接元宝，能在元宝 App 里创建 Bot
一杯水 ☕——15 分钟后三个腾讯系渠道随你挑

跟我做

第 1 步：安装 OpenClaw 微信插件（openclaw-weixin）

为什么：微信渠道不在 OpenClaw 核心里，是腾讯微信团队维护的外部插件。渠道 id 是 openclaw-weixin（weixin、wechat 是别名），CLI 命令和配置路径都用这个名字。

方式 A：官方 CLI 一键装（推荐）：

shell

npx -y @tencent-weixin/openclaw-weixin-cli install

方式 B：手动装插件包：

shell

openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw plugins enable openclaw-weixin

你应该看到：安装完成、无报错，openclaw plugins list 里出现 openclaw-weixin。插件命令会应用到运行中的 Gateway——Gateway 离线就先启动它。

💡 版本配套看一眼

插件 2.4.8（npm latest）声明要求 OpenClaw 2026.5.12 以上；OpenClaw 2026.1.0 ～ 2026.3.22 之间的老版本要装 legacy 线：openclaw plugins install @tencent-weixin/openclaw-weixin@legacy。插件报版本太老，就先 openclaw update。

openclaw plugins list 能看到 openclaw-weixin

第 2 步：扫码登录个人微信

为什么：微信插件用二维码登录——不用注册公众号、不用企业号，个人微信扫一下就通，账号令牌存在本机 ~/.openclaw 下。

在跑 Gateway 的同一台机器上执行：

shell

openclaw channels login --channel openclaw-weixin

用手机微信扫码并确认登录。你应该看到：扫码成功后令牌保存到本地；Gateway 启动时，插件会为每个已登录账号启动微信监听。

然后打开微信，私聊这个账号发一句「你好」——回复来了，链路就通了。

💡 这就是 OpenClaw 的独有价值

网页版 AI 永远进不了你的微信；这只 Claw 扫一下就住进你的私聊里，文字、图片等媒体消息直接处理，背后还是你自选的模型和全套技能。

⚠️ 微信只支持私聊

插件能力声明是 direct chats only——私聊和媒体可以，群聊不支持。别把它拉进群里测试，它不会说话。要群聊，用 QQ、元宝，或回看企微/飞书两课。

⚠️ 2.4.8 的配对（pairing）不可用

插件 2.4.8 没有注册 OpenClaw 的配对适配器，标准配对命令管不了微信私聊权限。它读的是旧版账号白名单文件，没有就退回扫码人的身份，两者都没有时任何发消息的人都能聊。自己扫码自己用没问题，别当公开服务跑；需要强制配对就先 openclaw plugins disable openclaw-weixin 等修复版（详见踩坑提醒）。

微信私聊发消息，机器人有回复

第 3 步：创建 QQ 机器人，拿到 AppID 与 AppSecret

为什么：QQ 渠道走官方 QQ Bot API（WebSocket 网关），凭据从 QQ 开放平台拿，全程不碰第三方协议。

打开 QQ 开放平台，用手机 QQ 扫码注册 / 登录
点 创建机器人（Create Bot）
在机器人设置页复制 AppID 和 AppSecret

你应该看到：设置页里 AppID 与 AppSecret 都能正常复制，AppSecret 已存进你的密码管理器。

⚠️ AppSecret 离开页面就找不回

官方文档明确提醒：AppSecret 要在离开开放平台页面前保存好，否则只能重新生成。

第 4 步：把 QQ 机器人接进 OpenClaw

为什么：QQ 是官方可下载插件（@tencent-connect/openclaw-qqbot），channels add 一条命令写入凭据，配置热生效。

shell

openclaw plugins install @tencent-connect/openclaw-qqbot
openclaw channels add --channel qqbot --token "<AppID>:<AppSecret>"

不想手敲凭据？openclaw channels add 走交互式向导，还支持用手机 QQ 扫码绑定。

对应的配置长这样（channels add 会帮你写好，这里供对照）：

json5

{
  channels: {
    qqbot: {
      enabled: true,
      dmPolicy: "open",
      allowFrom: ["openclaw:approval-disabled"],
      appId: "<你的AppID>",
      clientSecret: "<你的AppSecret>",
    },
  },
}

allowFrom 里的 openclaw:approval-disabled 是「关闭原生审批动作」的标记，想启用审批按钮就换成具体审批人的 QQ openid。凭据也可以走环境变量 QQBOT_APP_ID / QQBOT_CLIENT_SECRET（仅默认账号）；clientSecret 还支持 SecretRef 引用，避免明文落在配置文件里。

验证：

shell

openclaw channels status --probe

你应该看到：qqbot 渠道在线。QQ 里私聊机器人（C2C）发一句「你好」有回复；把它拉进群里 @ 它，也回。

💡 拿到你自己的 openid

私聊里发 /bot-me，机器人会回你的 QQ 用户 openid——第 6 步配白名单就靠它。注意每个机器人的 openid 独立：Bot A 的 openid 不能用在 Bot B 上。

openclaw channels status --probe 显示 qqbot 在线
QQ 私聊、群 @ 都能唤起机器人

第 5 步：接入腾讯元宝（Yuanbao）

为什么：元宝是腾讯的 AI 助手平台，元宝团队维护的 openclaw-plugin-yuanbao 走 WebSocket 连接，私聊和群聊都支持。要求 OpenClaw 2026.4.10+（本教程基准 v2026.10.9 满足）。

先在元宝 App 的应用设置里创建 Bot，拿到 appKey 和 appSecret，然后：

shell

openclaw channels add --channel yuanbao --token "<appKey>:<appSecret>"

交互式也行：openclaw channels login --channel yuanbao，按提示输入 App Key 和 App Secret。

你应该看到：openclaw channels status --probe 显示 yuanbao 在线；元宝里私聊 Bot 有回复；群里 @ 它才回——默认 requireMention: true，回复它的消息算隐式 @。

💡 元宝插件的事实口径

官方文档说明：元宝插件的配置与行为细节来自插件自家文档，未经 OpenClaw 核心源码验证。遇到行为差异，以元宝渠道官方文档为准。

元宝私聊有回复；群里 @ 有回复

第 6 步：收紧访问控制

为什么：默认策略偏开放——QQ 的 dmPolicy 在 allowFrom 没有具体条目时默认 open，元宝的 dm.policy 默认也是 open。自己尝鲜没事，账号一旦有外人够得着，先收紧。

QQ：把 /bot-me 拿到的 openid 写进白名单：

json5

{
  channels: {
    qqbot: {
      dmPolicy: "allowlist",
      allowFrom: ["<你的openid>"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["<群openid>"],
    },
  },
}

元宝：dm.policy 有 open / pairing / allowlist / disabled 四档：

json5

{
  channels: {
    yuanbao: {
      dm: {
        policy: "allowlist",
        allowFrom: ["<用户ID>"],
      },
    },
  },
}

想省事就用 pairing：新人私聊会收到配对码，你在 CLI 里审批：

shell

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

微信：2.4.8 没有可用的配对机制（见第 2 步警告）——靠「只有扫码人自己用」这个事实兜底，别把账号借给公开场景。

你应该看到：白名单外的人私聊或在群里说话，机器人不再回复。

访问控制的完整体系见安全加固（一）：访问控制与身份。

📋 魔法 Prompt

以下 Prompt 直接粘贴进对应渠道的聊天窗口发给你的 AI 助手。

📝 微信速记员

预期效果：微信私聊里随手丢一段会议转写或碎碎念，拿回一份能直接用的结构化速记。

## 角色
你是我的私人速记员，擅长把口语化的一堆话整理成清晰笔记。
## 任务
把下面这段材料整理成速记发给我。
## 输入信息
### 必填项
- 材料：【把会议转写、语音稿或随手记的想法直接粘贴在这里】
### 选填项
- 用途：【这份笔记之后要用来做什么？例如写周报、准备复盘?】
## 输出规范
分「要点 / 待办 / 存疑」三段；待办尽量带负责人和截止时间。
## 约束条件
- ✅ 保留材料里的具体数字、人名、时间
- ✅ 看不懂或存疑的内容放进「存疑」，别猜
- ❌ 不要补写材料里没有的结论

⏳ 每日早报推进 QQ 私聊

预期效果：AI 用内置调度器创建定时任务，每个工作日早上把 AI 领域早报自动发到你的 QQ 私聊——对话里说一句就建好。

创建一个定时任务：每个工作日早上 8 点 30 分给我发一份 AI 领域早报。
要求：
- 挑 5 条昨天最重要的 AI 新闻，每条一句话摘要加原文链接
- 结尾附一句今天值得做的一件事
- 投递到我的 QQ 私聊

⚠️ 主动消息都有门槛

QQ 可能拦截机器人主动发起的消息——如果你最近没和它互动过。微信更硬：出站消息要带对方入站消息下发的 context token，没收到过你的消息，插件会直接拒绝发送（详见进阶技巧）。早报偶尔没到，先私聊机器人一句再观察。定时任务的完整玩法见 Automations 定时任务。

✅ QQ 群讨论收敛器

预期效果：群里刷屏的讨论，@ 机器人加这段指令，压成三段能执行的结论——不用爬楼。

## 角色
你是讨论主持，擅长把刷屏的群聊压成清晰的结论。
## 任务
把下面这段群聊记录收敛成摘要，发回本群。
## 输入信息
### 必填项
- 记录：【粘贴群聊记录或会议转写】
### 选填项
- 背景：【这场讨论的前提是什么?】
## 输出规范
按「结论 / 待办 / 遗留问题」三段输出；待办用表格：事项 | 负责人 | 截止时间。
## 约束条件
- ✅ 每条待办指到具体的人
- ✅ 没定的事放进「遗留问题」
- ❌ 不要逐句复述聊天记录

检查点 ✅

openclaw plugins list 能看到 openclaw-weixin；openclaw channels status --probe 显示已配的渠道在线
微信私聊有回复（群聊不支持，别在群里测）
QQ 私聊和群 @ 都能唤起机器人；/bot-me 拿到了你的 openid
元宝私聊有回复；群里 @ 才回（默认行为）
三个渠道的访问策略都想了一遍：该收紧的收紧，或明确决定保持开放

踩坑提醒

❌ 把机器人拉进微信群，它一声不吭

原因：微信插件的能力声明是 direct chats only——只支持私聊和媒体，群聊不在能力范围内。

正确做法：微信里只私聊用。要群聊，去 QQ / 元宝，或用企微/飞书。

❌ 微信 2.4.8 想用标准配对管权限，管不住

原因：这一版没注册配对适配器，标准配对列表 / 审批命令建立不了微信私聊权限。插件读的是旧版账号白名单文件，没有就退回扫码人身份，两者都没有时任何发信人都能聊。而且 openclaw doctor --fix 会把旧白名单导入 SQLite 并删掉源文件——旧文件里放行过的人可能因此掉权限；之后在 SQLite 里撤销，也撤不掉旧文件或扫码兜底授予的权限。

正确做法：别依赖标准配对管理微信权限。自己扫码自己用最稳；需要强制配对的场景，先 openclaw plugins disable openclaw-weixin 停用插件，等支持配对的版本发布。

❌ QQ AppSecret 没存就关了页面

原因：开放平台的 AppSecret 离开页面就查不到了。

正确做法：复制 AppID / AppSecret 后先存进密码管理器。丢了就在机器人设置页重新生成，再把配置里的 clientSecret 更新成新值。

❌ QQ 定时早报从没送达

原因：QQ 可能拦截机器人主动发起的消息——用户近期没和它互动的话。

正确做法：建完定时任务后先私聊机器人一句，保持互动；或把「主动推送」改成「到点我问它」。

❌ 元宝群里 @ 了没反应

按官方排错顺序查：① 确认 Bot 已加进群；② 确认是 @ 它（默认必须 @，回复它的消息算隐式 @）；③ openclaw logs --follow 看日志。还不行就确认 Bot 在元宝 App 里已创建并通过审核、openclaw gateway status 显示 Gateway 在跑。

❌ 微信插件装上后 Gateway 反复重启

原因：老版本 OpenClaw 有一个通用的 stale-Gateway 清理 bug（issue #68451）——插件的辅助进程可能误杀启动它的 Gateway，在 systemd 这类进程管理器下表现为重启循环；另外插件 2.4.6 在 OpenClaw 2026.8.1 上加载不了（引用了已退役的 SDK 路径）。

正确做法：OpenClaw 和插件一起更新：

shell

npm view @tencent-weixin/openclaw-weixin version
openclaw plugins install "@tencent-weixin/openclaw-weixin" --force
openclaw gateway restart

进阶技巧（可选）

微信进阶：多账号、主动消息与消息行为

再跑一次 openclaw channels login --channel openclaw-weixin 添加第二个账号。多账号时把私聊会话按「账号 × 渠道 × 发送者」隔离，避免串会话：

shell

openclaw config set session.dmScope per-account-channel-peer

定时 / 主动消息有硬门槛：微信后端要求每条出站消息携带一个 context token，它由对方发来的入站消息下发、插件按账号保存。没收到过对方消息、或 token 已失效时，插件会拒绝发送，不会假装成功。

所以定时任务推微信前，先让对方私聊一句刷新 token；多账号部署的定时任务要同时显式设置 delivery.to 和 delivery.accountId，缺失或歧义都会失败。token 是敏感数据，别跨账号复制或写进任务配置。

消息行为可以调。以下字段来自 openclaw-weixin 详细指南（社区发行版文档，与腾讯官方包同一上游、同一插件 ID）：

字段	默认	说明
`channels.openclaw-weixin.replyProgressMessages`	`true`	工具调用的 `TOOL_CALL_START` / `TOOL_CALL_RESULT` 进度消息，嫌吵可设 `false`（不影响最终回复）
`channels.openclaw-weixin.blockStreaming`	开启	分块回复：按顺序发多步工具调用之间的文本块（不是逐 token 流式）；`false` 只发最终回复，可用 `accounts.<账号>.blockStreaming` 单独覆盖
`channels.openclaw-weixin.botAgent`	`OpenClaw`	UA 风格的自我声明（如 `MyBot/1.2.0`），仅用于后台观测，不参与鉴权或路由

⚠️ 卸载会连带删配置

卸载插件会删掉 channels.openclaw-weixin 配置——以后可能重装，就先备份 ~/.openclaw/openclaw.json。在腾讯官方包与社区发行版之间互换时，原地安装覆盖即可，不要先卸载，配置和登录状态会保留。社区发行版要求更新的 OpenClaw，报 requires OpenClaw >=2026.6.1 就先 openclaw update。

QQ 多机器人与群策略

多账号：openclaw channels add --channel qqbot --account bot2 --token "<AppID2>:<Secret2>"——每个账号独立 WebSocket 连接和凭据缓存，日志带账号 id
群默认策略：groups["*"] 给所有群设默认（如 requireMention: true），具体群用真实群 openid 覆盖
群命令分级：commandLevel 三档——all（全部内置命令）、safety（群里只留 /help /btw /stop，敏感命令回私聊）、strict（只留会话控制类）
群历史上下文：historyLimit 默认 50 条，设 0 关闭

元宝回复调优

字段	默认	说明
`channels.yuanbao.outboundQueueStrategy`	`merge-text`	出站合并：攒到 2800 字或空闲 5 秒再发；`immediate` 逐段即发
`channels.yuanbao.maxChars`	`3000`	单条消息上限，超出按 `overflowPolicy`（`split` / `stop`）处理
`channels.yuanbao.replyToMode`	`first`	群里引用回复策略：`off` / `first` / `all`
`channels.yuanbao.historyLimit`	`100`	群聊上下文条数
`channels.yuanbao.fallbackReply`	暂时无法解答，你可以换个问题问问我哦	模型无内容时的兜底话术，可自定义

本课小结

✅ 你现在能：

完成 OpenClaw 微信接入：扫码登录，个人微信私聊里直接用（群聊不支持）
QQ 机器人从 q.qq.com 建号到进群 @ 值守，一条命令接进 OpenClaw
元宝 Bot 用 appKey:appSecret 配好，私聊群聊都有人
按渠道选对收紧方式：QQ 白名单、元宝配对码、微信扫码自用

关键配置字段回顾：

字段	推荐值	说明
`channels.qqbot.appId` / `clientSecret`	开放平台凭据	也支持环境变量 `QQBOT_APP_ID` / `QQBOT_CLIENT_SECRET`（仅默认账号）
`channels.qqbot.dmPolicy` / `groupPolicy`	`allowlist`	默认 `open`，上线前收紧
`channels.yuanbao.appKey` / `appSecret`	元宝 App 创建 Bot 获得	`--token "appKey:appSecret"` 一次写入
`channels.yuanbao.dm.policy`	`allowlist` 或 `pairing`	默认 `open`；配对审批 `openclaw pairing approve yuanbao <CODE>`
`channels.yuanbao.requireMention`	`true`（默认）	群里必须 @ 才回
`session.dmScope`	`per-account-channel-peer`	微信多账号时隔离私聊会话

下一课预告

下一课 A4 邮件助手：IMAP 收件箱值班，你会学到：

IMAP 插件怎么监听收件箱，为每封放行的来信开一个隔离的受限 reader 会话
发件人门控：怎么决定哪些来信值得唤醒 AI
Gmail 用户的 Pub/Sub 触发方式
邮件值班的安全边界：不发邮件、不改 flags、不开公网 webhook

聊天渠道到这就配齐了——下一课让 AI 把你的邮箱也一起值了。

微信、QQ 与元宝：腾讯系渠道接入 ​

学完你能做什么 ​

为什么用 OpenClaw，而不是网页版 AI？ ​

你现在的困境 ​

什么时候用这一招 ​

🎒 开始前的准备 ​

跟我做 ​

第 1 步：安装 OpenClaw 微信插件（openclaw-weixin） ​

第 2 步：扫码登录个人微信 ​

第 3 步：创建 QQ 机器人，拿到 AppID 与 AppSecret ​

第 4 步：把 QQ 机器人接进 OpenClaw ​

第 5 步：接入腾讯元宝（Yuanbao） ​

第 6 步：收紧访问控制 ​

📋 魔法 Prompt ​

📝 微信速记员 ​

⏳ 每日早报推进 QQ 私聊 ​

✅ QQ 群讨论收敛器 ​

检查点 ✅ ​

踩坑提醒 ​

❌ 把机器人拉进微信群，它一声不吭 ​

❌ 微信 2.4.8 想用标准配对管权限，管不住 ​

❌ QQ AppSecret 没存就关了页面 ​

❌ QQ 定时早报从没送达 ​

❌ 元宝群里 @ 了没反应 ​

❌ 微信插件装上后 Gateway 反复重启 ​

进阶技巧（可选） ​

微信进阶：多账号、主动消息与消息行为 ​

QQ 多机器人与群策略 ​

元宝回复调优 ​

本课小结 ​

下一课预告 ​

微信、QQ 与元宝：腾讯系渠道接入

学完你能做什么

为什么用 OpenClaw，而不是网页版 AI？

你现在的困境

什么时候用这一招

🎒 开始前的准备

跟我做

第 1 步：安装 OpenClaw 微信插件（openclaw-weixin）

第 2 步：扫码登录个人微信

第 3 步：创建 QQ 机器人，拿到 AppID 与 AppSecret

第 4 步：把 QQ 机器人接进 OpenClaw

第 5 步：接入腾讯元宝（Yuanbao）

第 6 步：收紧访问控制

📋 魔法 Prompt

📝 微信速记员

⏳ 每日早报推进 QQ 私聊

✅ QQ 群讨论收敛器

检查点 ✅

踩坑提醒

❌ 把机器人拉进微信群，它一声不吭

❌ 微信 2.4.8 想用标准配对管权限，管不住

❌ QQ AppSecret 没存就关了页面

❌ QQ 定时早报从没送达

❌ 元宝群里 @ 了没反应

❌ 微信插件装上后 Gateway 反复重启

进阶技巧（可选）

微信进阶：多账号、主动消息与消息行为

QQ 多机器人与群策略

元宝回复调优

本课小结

下一课预告