腾讯元宝在两边都能接,但一个是内置集成一个是渠道插件

2026-08-16

腾讯元宝这个渠道有点特别:它在两边的文档里都有,而且两边都把它归在中文区/国内平台这一类。

先说形态前提:WorkBuddy 是商业闭源桌面客户端(元宝派是产品内置集成);OpenClaw 是 MIT 开源自托管 Gateway 网关(腾讯元宝在它的中文区渠道分组里,与微信、QQ Bot 并列)。

依据:WorkBuddy 官方文档《接入元宝机器人指南》(Platform-Integration/YuanBaoPai-Guide);OpenClaw 官方中文文档 zh-CN/channels/(腾讯元宝页在中文区渠道分组下)。核对日均为 2026-08-16。腾讯元宝侧规则以其官方为准。我们没有安装任何一方,本文不含实测数据。

一、WorkBuddy 侧:一条双向流程

这是元宝派接入最值得注意的特点——它是双向的,两边各配一半,最后要回元宝 App 确认才算完成

前提:客户端已安装并开启了助理远程控制功能;已安装腾讯元宝 App 并完成登录(官方提示支持微信登录)。

第一步:在元宝 App 里创建 Bot

打开元宝 App → 点底部导航栏「」标签 → 点顶部「我的 Bot」→ 右上角「创建 Bot」→ 点「关联 Open 助理」进入关联配置页面。

官方说明本指南以手动配置为主——把 AppID 和 AppSecret 填进 WorkBuddy 完成绑定。

这一步做完先别走,关联配置页面停在那儿,等会儿要回来。

第二步:在 WorkBuddy 里注册

左下角头像 →「设置 - 助理设置」→「集成(BETA)」区域找到「元宝机器人集成」→ 点「配置」→ 在「注册元宝通道」对话框里填凭证 → 点「注册」。

这里有个字段名对不上的坑

元宝 App 给你的填进 WorkBuddy 的哪个框
AppIDApp Key」输入框
AppSecret「App Secret」输入框

AppID → App Key。 是同一个东西,只是叫法不同。第一次配的人容易在这儿愣住,以为拿错了凭证。

官方在这里标了「重要」:请确保 AppID 和 AppSecret 复制完整,避免带入多余空格或遗漏字符。

注册成功后,「元宝机器人集成」会显示「已连接」。

第三步(最容易漏):回元宝 App 点「我已操作」

官方原文:回到元宝 App 的关联页面,点击底部的「我已操作」按钮确认关联。

关联成功后页面显示「关联成功」并展示 Bot 信息,这时可以点「开始聊天」,或者「添加到已有的派」把 Bot 加进群聊。

为什么这一步必须做:WorkBuddy 那边显示「已连接」,说的是它这一侧的通道注册好了;元宝那边还在等你确认关联。两边都点头,链路才通。

所以遇到「WorkBuddy 显示已连接但元宝里聊不通」,先回元宝看看这一步做了没有

二、OpenClaw 侧:渠道插件路径

OpenClaw 的腾讯元宝在文档的中文区渠道分组里。从同分组的微信页能看出这类渠道的通用架构(官方原文口径):

OpenClaw 提供通用渠道插件契约,外部插件提供渠道专用运行时。

对应的操作模式是:装插件 → 启用 → 重启 Gateway 网关 → 命令行完成登录;准入用 OpenClaw 的配对和允许列表模型openclaw pairing list <channel> / approve)。

具体到腾讯元宝页的细节,以 OpenClaw 官方文档为准——本文重点是并列关系与 WorkBuddy 侧的可操作项。

三、并列对照

WorkBuddy 元宝派OpenClaw 腾讯元宝
形态产品内置集成渠道插件(核心与渠道分离)
配置方式客户端界面 + 元宝 App 双向确认命令行(装插件 → 重启网关 → 登录)
有没有「确认关联」这一步(回 App 点「我已操作」)以官方文档为准
群组用法关联成功页点「添加到已有的派以官方文档为准
准入控制官方文档未提供该平台的准入配置说明配对与允许列表模型
凭证可否重置可以——官方说明凭据失效可在元宝 App 中重新创建 Bot 获取新凭据以官方文档为准

最后一行值得单独说:元宝这边的凭证可以重来,比 QQ 宽松得多——QQ 的 AppSecret 官方明确不支持明文保存、二次查看将强制重置,只有一次机会。

四、想在群(派)里用,先想清楚一件事

「派」是元宝里的群组概念。把 Bot 加进去之后,群里的人就能跟它交互。

但这个 Bot 背后连的是你自己那台电脑。 群里任何人给它下的指令,都会在你的电脑上执行、动你的文件。

官方在使用技巧里的「先本地后远程」讲的正是这个风险:远程遥控意味着它在你看不见的地方自主行动,执行了超出预期的操作你未必来得及叫停

群聊场景比一对一远程又多一层——下指令的人可能不止你一个。

加进派之前的四条准备

  • 先把工作目录规划好——官方建议每类任务建独立文件夹,命名示例是 weekly-reportinvoice-archivecustomer-data-cleanupbatch-image-processing
  • 权限保持默认——官方原话是完全访问并不更安全,只是让 AI 自动跳过确认步骤;
  • 别在派里处理敏感数据——结果会发在群里;
  • 想清楚这个派里都有谁

五、官方给的三条排查

1)机器人没有响应:检查电脑上的 WorkBuddy 正在运行且助理服务已开启;确认「元宝机器人集成」显示为「已连接」;核对 AppID 和 AppSecret 是否与元宝 App 中的一致;检查网络连接。

在这四条之前,先补一条你的电脑是不是活着。 官方在助理文档「注意事项」里明写电脑需要保持开机并运行 Tencent WorkBuddy——这条能解释绝大多数「时好时坏」。

2)注册失败:确认元宝 App 中已完成 Bot 创建并获取到凭证;重新复制凭据,确保没有遗漏或多余字符;检查助理服务是否正常运行;凭据失效可在元宝 App 中重新创建 Bot 获取新凭据

3)如何解除绑定:在「助理设置」页面找到「元宝机器人集成」,点「解绑」。

六、凭证处理的通用习惯

官方在多个平台的指南里反复提醒「避免带入多余空格或遗漏字符」,说明这是高频问题。

统一做法:复制凭证后,先粘到纯文本编辑器(记事本 / TextEdit)里看一眼首尾,确认没有多余空格或换行再填。首尾空白肉眼完全看不出来,但会让注册直接失败。别在两个网页输入框之间直接来回复制。

七、什么情况选哪个(按官方自述定位归因)

  • 已经在用元宝,想顺手接上、还想在派里共用 → WorkBuddy 的元宝派接入是产品内置的,界面配置;
  • 已经在跑 OpenClaw 网关,想把元宝并进已有的多渠道体系 → OpenClaw 的插件路径;
  • 你需要细粒度准入控制 → OpenClaw 有配对与允许列表模型;
  • 你只想最省事 → WorkBuddy 侧的微信助理更短:官方明确无需填写 App ID、App Secret 等开发凭证,只需扫码(要求 WorkBuddy ≥ 4.6.4、微信 ≥ 8.0.70)。

八、我们不写的东西

  • 不写谁的元宝接入更好——形态不同,比较没有意义;
  • 不复述 OpenClaw 腾讯元宝页的配置细节——以其官方文档为准;
  • 不写两边元宝渠道的能力差异(如群聊支持范围)——需逐条核对各自官方文档,本文未展开。

小结

  • WorkBuddy 侧是双向流程:元宝 App 创建 Bot 拿凭证 → WorkBuddy 注册 → 回元宝点「我已操作」确认关联第三步最容易漏。
  • ★ 字段名对不上:AppID 要填进「App Key」输入框
  • 入口:元宝 App 底部「」→ 顶部「我的 Bot」→ 右上角「创建 Bot」→「关联 Open 助理」;WorkBuddy 左下角头像 →「设置 - 助理设置」→「集成(BETA)」→「元宝机器人集成」。
  • 凭证可以重来(重新创建 Bot 获取新凭据),比 QQ 的一次性 AppSecret 宽松。
  • 想在派里用:关联成功页点「添加到已有的派」;但群里所有人都能指挥你那台电脑,先规划好工作目录、权限保持默认、别处理敏感数据。
  • OpenClaw 侧走渠道插件路径(装插件 → 重启网关 → 命令行登录),准入用配对与允许列表模型
  • 共同前提:宿主得活着

双方功能与文档表述均以各自官方为准,腾讯元宝侧规则以其官方为准,核对日 2026-08-16。

想系统学会用 AI?报名体系课或加入会员,照着学、照着用。