WorkBuddy 怎么接元宝派？AppID 要填进「App Key」那个框

2026-08-16

元宝派这条接入路径有个特点：它是双向的——两边各配一半，最后要回元宝 App 点一下确认才算完成。很多人在 WorkBuddy 这边看到「已连接」就以为结束了，结果发现聊天还是不通。

还有一个小坑：两边的字段名对不上。 元宝那边给你的叫 AppID，WorkBuddy 这边的输入框叫「App Key」。

本文依据 WorkBuddy 官方文档《接入元宝机器人指南》（Platform-Integration/YuanBaoPai-Guide），核对日 2026-08-16。腾讯元宝侧的规则以其官方为准。我们没有安装客户端，界面文案以你实际看到的版本为准。

一、前提条件

官方给的两条：

已在电脑上安装 WorkBuddy，并开启了助理远程控制功能；
已安装腾讯元宝 App 并完成登录。

官方提示：没装元宝的话，在各大应用商店搜「元宝」下载安装，支持微信登录。

「支持微信登录」这句挺关键——意味着你不需要单独注册一个新账号。

二、第一步：在元宝 App 里创建 Bot

官方给的路径：

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

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

这一步做完先别走。 关联配置页面停在那儿，等会儿还要回来点最后一下。

三、第二步：在 WorkBuddy 里注册

打开 WorkBuddy，点左下角的头像；
弹出菜单里点「设置 - 助理设置」；
在「集成（BETA）」区域找到「元宝机器人集成」，点右侧的「配置」按钮；
在弹出的「注册元宝通道」对话框中填凭证；
点「注册」完成绑定。

字段名对不上，别填错

这是本文开头说的那个坑，单独列出来：

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

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

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

建议：复制之后先粘到纯文本编辑器（记事本 / TextEdit）里看一眼首尾，确认没有多余空格或换行再填。首尾空白肉眼看不出来，但会让注册直接失败。

确认绑定状态

注册成功后，返回「助理设置」页面，「元宝机器人集成」会显示「已连接」状态。

但到这一步还没完。

四、第三步：回元宝 App 点「我已操作」

这是最容易漏的一步。官方原文：

回到元宝 App 的关联页面，点击底部的「我已操作」按钮确认关联。

关联成功后，页面会显示「关联成功」提示，并展示你的 Bot 信息。这时候有两个选择：

点「开始聊天」立即体验；
或者「添加到已有的派」把 Bot 加进群聊。

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

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

五、想在群里用

官方给的入口是关联成功页面上的「添加到已有的派」。

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

加进群之前，先想清楚一件事：这个 Bot 背后连的是你自己那台电脑。群里任何人给它下的指令，都会在你的电脑上执行、动你的文件。

所以：

别把它加进不熟悉的群；
加进群之前，先把工作目录规划好——官方建议每类任务建独立文件夹，命名示例是 weekly-report、invoice-archive 这种；
别在群里用的时候处理敏感数据——你不知道谁会看到结果。

官方在使用技巧里有一条「先本地后远程」，讲的正是这个风险：远程遥控意味着它在你看不见的地方自主行动，执行了超出预期的操作你未必来得及叫停。建议先在桌面端边看边用，摸清执行方式和风险边界，再逐步放手。

群聊比一对一远程的风险更高一层——因为下指令的人可能不止你一个。

六、联通测试

配完之后官方建议发一条简单消息测试，官方给的例子是「我来做个测试的」。

如果配置正确，WorkBuddy 会接收到消息并在元宝派中返回回复。

七、官方给的三条排查

1）机器人没有响应

检查 WorkBuddy 状态：确保电脑上的客户端正在运行，且助理服务已开启；
检查绑定状态：确认「元宝机器人集成」显示为「已连接」；
检查凭据：核对 AppID 和 AppSecret 是否与元宝 App 中的一致；
检查网络连接。

在这四条之前，先补一条官方没写但更基础的：你的电脑是不是活着。这条链路的终点是你自己电脑上运行的客户端——关机、休眠、客户端退出，机器人一定不回复，而且在元宝那边怎么查都查不出来。这也完美解释「时好时坏」：你在电脑前的时候好好的，人一走电脑睡了就失联。

2）注册失败

确认元宝 App 中已完成 Bot 创建并获取到 AppID 和 AppSecret；
重新复制凭据，确保没有遗漏或多余字符；
检查 WorkBuddy 的助理服务是否正常运行；
如凭据已失效，可在元宝 App 中重新创建 Bot 获取新凭据。

最后一条挺重要——元宝这边的凭证是可以重新生成的。这跟 QQ 那边不一样：QQ 的 AppSecret 官方明确说明不支持明文保存、二次查看将强制重置，只有一次机会。

3）如何解除绑定

在 WorkBuddy 的「助理设置」页面找到「元宝机器人集成」，点「解绑」按钮。

八、跟其他平台比，元宝派适合谁

你的情况	建议
已经在用元宝，想顺手接上	元宝派，流程不长
想在一个小圈子的群里共用	元宝派（有「派」这个群组概念，可加进已有的派）
只想最省事，不碰任何凭证	微信助理——官方明确说明无需填写 App ID、App Secret 等开发凭证，只需扫码（要求 WorkBuddy ≥ 4.6.4、微信 ≥ 8.0.70）
组织内多人用、要管权限	企业微信（有「可见范围」，可指定成员、部门或标签）

小结

三步：元宝 App 创建 Bot 拿凭证 → WorkBuddy 注册 → 回元宝点「我已操作」确认关联。第三步最容易漏。
★ 字段名对不上：AppID 要填进「App Key」输入框，AppSecret 填进「App Secret」。
入口：元宝 App 底部「派」→ 顶部「我的 Bot」→ 右上角「创建 Bot」→「关联 Open 助理」；WorkBuddy 左下角头像 →「设置 - 助理设置」→「集成（BETA）」→「元宝机器人集成」。
凭证要复制完整不带空格，先过一道纯文本编辑器。
想在群里用：关联成功页点「添加到已有的派」。但群里所有人都能指挥你那台电脑，先规划好工作目录、别处理敏感数据。
凭证失效可以重新创建 Bot 获取新的（不像 QQ 的 AppSecret 只有一次机会）。
解绑：助理设置里点「解绑」。

功能与流程以官方为准，腾讯元宝侧规则以其官方为准，核对日 2026-08-16。