腾讯元宝在两边都能接,但一个是内置集成一个是渠道插件
腾讯元宝这个渠道有点特别:它在两边的文档里都有,而且两边都把它归在中文区/国内平台这一类。
先说形态前提: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 的哪个框 |
|---|---|
| AppID | 「App 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-report、invoice-archive、customer-data-cleanup、batch-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。