WorkBuddy 接入 QQ 机器人与元宝派：AppID/AppSecret 怎么配、坑在哪

2026-08-08

WorkBuddy（Tencent WorkBuddy）的助理支持九个平台，但这九个的接入成本差得很远。微信只要扫个码，钉钉和飞书得先有企业管理员权限、还要开一长串权限。QQ 机器人和腾讯元宝的「派」正好卡在中间同一档：都要去对应平台建一个 Bot，拿到一对 AppID 和 AppSecret，回填进 WorkBuddy 就算接完了。

流程同构，所以放在一篇里讲。两边各有一个官方文档写明、但很容易在操作时吃亏的地方，我会单独标出来。

一、先确认这件事你是不是真需要

助理的本质是遥控器：手机上发消息 → 电脑上的 WorkBuddy 执行 → 结果回到手机。官方文档就是这么定位的。

这决定了一个前提，接之前先问自己能不能接受：使用助理时电脑必须保持开机并运行 WorkBuddy，网络也要正常。它不是云端服务，你的电脑关了机，QQ 里发再多消息也没有任何东西在跑。

官方给的典型场景是出门在外让电脑处理文件、会议中快速生成纪要、通勤路上提前安排材料。共同点都是”人不在电脑前，但电脑还开着”。如果你的电脑是笔记本、下班就合盖带走，接了也用不上。

还有一条要先知道：官方明确说助理不支持修改默认文件夹——它专门用于远程任务，这个设定改不了。所以后面写指令时，路径得在指令里说清楚，不能指望默认目录替你兜底。

二、QQ 机器人：第一道门是实名认证

前提：QQ 开放平台要求账号完成实名认证。如果还没认证，得先在 QQ 里完成，这一步在开放平台上绕不过去。

接入步骤：

访问 QQ 开放平台，用 QQ 扫码登录
点「创建机器人」。点击后会立刻成功，机器人还会给你的 QQ 发一条成功消息；头像和昵称可以自定义
复制机器人的 AppID 和 AppSecret
回到 WorkBuddy，点头像 →「设置 - 助理设置」→ 配置「QQ 机器人集成」→ 填入 AppID 和 AppSecret → 点「注册」
成功后「QQ 机器人集成」会显示已连接，「助理」里也能看到 QQ 图标

第 3 步有个必须当场处理的坑，官方文档专门标了「重要」：

出于安全考虑，AppSecret 不支持明文保存，二次查看将会强制重置。

翻译成人话就是：这串东西你只有这一次机会原样拿到。你要是想着”先建着，回头有空再配”，下次回去看它就被重置了，之前记下的那串直接作废，得重新走一遍配置。所以建完机器人别关页面，先把 AppID 和 AppSecret 存进密码管理器再做别的事。

三、元宝派：坑在字段名对不上

前提：已安装腾讯元宝 App 并完成登录（支持微信登录）。这条比 QQ 那边轻，不涉及开放平台的实名流程。

接入步骤：

打开元宝 App，点底部导航栏的「派」标签，进入顶部「我的 Bot」
点右上角「创建 Bot」→ 选「关联 Open助理」，进入关联配置页
官方指南以手动配置为主，在这里拿到 AppID 和 AppSecret
回到 WorkBuddy，点左下角头像 →「设置 - 助理设置」→ 找到「集成（BETA）」区域 →「元宝机器人集成」→ 点「配置」
在弹出的「注册元宝通道」对话框里填两个框，然后点「注册」

第 5 步就是那个坑。两边的字段名对不上：

元宝那边叫	WorkBuddy 输入框叫
AppID	App Key
AppSecret	App Secret

也就是说，AppID 要填进「App Key」这个框。这是官方文档写明的对应关系，不是笔误。第一次配的人看到「App Key」很容易愣一下——手上明明只有 AppID 和 AppSecret，哪来的 Key——然后要么回元宝去翻有没有另一个字段，要么干脆填反。知道这一条，能省一次卡壳。

四、两个平台共通的一条：凭证就是控制权

AppSecret 不是普通的配置项。助理的定位是远程控制你的电脑，这串凭证泄露，等于把你电脑的远程操作入口交出去了。所以：

别把它贴在群里、便签里、代码仓库里，也别为了”方便”截图存相册
存进密码管理器，或者至少存在一个只有你能打开的地方
QQ 那边还有个额外理由：反正二次查看就会强制重置，你不第一时间存好，后面也没得看

顺带说一句，接入完成不等于万事大吉。官方在上手技巧里给了一条挺清醒的提醒：远程遥控意味着它在你看不见的地方自主行动，一旦执行了超出预期的操作，你未必来得及叫停。建议是新手先在桌面端边看边用，摸清它的执行方式和风险边界，再往手机上放。

五、接通之后：手机上的指令怎么写

接入本身十分钟能搞定，真正决定这东西好不好用的是指令。手机上打字慢、看不到电脑屏幕，所以指令反而要比在电脑前写得更死。

官方给的公式是 做什么 + 有什么 + 怎么样，配套的四要素是「目标 / 输入 / 输出格式 / 约束」。套到 QQ 或元宝里发过去的消息，长这样：

请整理今天的会议材料。

【输入】读取 D:/工作/会议/2026-08-08 目录下的所有文档。

【目标】整理成一份正式会议纪要，包含会议主题、关键结论、
行动项、负责人和截止时间。

【输出格式】生成 Word 文件，保存到 D:/工作/会议/纪要 目录，
文件名为「会议纪要_2026-08-08.docx」。

【约束】只写材料里有依据的内容；无法确认的负责人和截止时间
留空并标注「待确认」，不要替我推测。完成后把纪要要点回复给我。

其中会议纪要那几项内容，是官方《实践案例》里给的原话口径，可以直接抄。要额外注意的是三处：

一是路径必须写全。 前面说了助理不支持改默认文件夹，你在手机上又看不到目录树，路径含糊它就得猜。

二是输出格式必须指定。 官方常见问题里专门有一条”生成的文件打不开”，给出的常见原因就是没在需求中明确指定输出文件类型，做法是下达任务时说清楚要 Word、Excel、PDF 还是 Markdown。远程场景下你连文件都看不到，这条更要守。

三是让它把要点回复给你。 电脑上生成了文件你看不见，指令末尾加一句”完成后回复要点”，手机上才能判断这一轮跑得对不对。

还有一个远程特有的限制要提前知道：官方说明，在移动端要求上传桌面文件时可能提示无法完成（Windows 环境下，飞书、企微、QQ、钉钉、微信移动端都涉及），这受设备权限、路径访问方式与平台能力限制，官方建议改为在本机侧明确指定文件路径后再执行。所以远程这条链路更适合”让电脑读本地文件、产出本地文件”，而不是”把手机上的东西传过去”。

六、交付物落在哪、怎么验收

交付物就是你在指令里指定的那个文件，落在你指定的目录，加上 QQ 或元宝对话框里回给你的那段要点。人要检查的是这三处：

对话里回的要点，和你预期的输入范围对不对得上。 如果它回的内容里出现了你没让它读的项目，说明目录范围写歪了，趁早叫停比等回到电脑前再看划算。
有没有编。 会议纪要里的负责人、截止时间最容易被补全出来。指令里已经要求”留空并标注待确认”，验收时就重点看这些空位是不是老老实实空着——如果全填满了，反而要警惕。
回到电脑前再确认文件本身。 手机上只能看到摘要，格式、排版、是否落在正确目录，这些还是得开机确认一次。

另外有个容易困惑的现象值得先记着：官方说明，助理工作空间里只有最近产生对话的任务会在「助理」中展示，其他任务只在工作空间列表里展示。所以在手机上翻不到前几天那条会话不代表丢了，去工作空间列表找。官方还顺带给了个建议——在电脑端新建任务时，不建议把助理选作工作空间。

七、连不上、不回复的时候

QQ 这边最常见的反馈是机器人频繁断开或者干脆不回复。官方文档给的做法是：优先切换模型再测一次（部分无响应问题可以通过切换模型缓解）；如果切了还是不行，记录错误码、发生时间和网络环境，再走进一步排查。

先切模型这个建议听起来有点绕，但官方在几处排查条目里都是这个口径——回复乱码、长时间无响应、任务卡住，第一步都是换个模型试。原因大概率是这类问题里有相当一部分不出在通道上。所以别一上来就怀疑自己 AppSecret 填错了，先换模型花不了半分钟。

如果连注册都没成功，先回头核对两件事：WorkBuddy 是不是正在运行、凭证有没有填错框（元宝那边尤其容易，见第三节的对照表）。

八、什么情况别用这条链路

第一，电脑不能常开的。 这是硬前提，前面已经说过，这里再强调一次：电脑不开机，接了也是摆设。与其接完发现天天没响应，不如一开始就判断清楚。

第二，需要频繁人工确认的任务。 远程链路的信息带宽很窄——你只能看到它回的文字，看不到过程。凡是”要看一眼再决定下一步”的活儿，在手机上来回确认的成本比坐到电脑前干还高。官方在远程遥控的实践建议里也是这个思路：可以让它先查、先给原因和处理建议，再决定是否动手改。

第三，涉及删除、覆盖、批量移动的操作。 官方的使用建议写得很直接：这类操作先要求预览。远程场景下你看不见执行现场，一旦它理解偏了，等你发现文件已经动过了。要么等回到电脑前再做，要么在指令里明确要求”先展示预览结果，我确认后再执行”。

第四，敏感文件的批量处理。 助理读得到的是你授权的工作目录，远程发指令时你没法临时判断目录里混进了什么。合同、薪酬这类东西，别放在远程会碰到的目录里。

小结

QQ 和元宝派的接入是同一套动作：平台建 Bot、拿一对 AppID 和 AppSecret、回填 WorkBuddy 点注册。QQ 多一道实名认证的门槛，且 AppSecret 二次查看会强制重置，必须当场存好；元宝那边要记住 AppID 填进「App Key」框。

接完之后真正要花心思的是指令：路径写全、格式指定、要求回复要点。至于删除覆盖这类动作，远程就先要预览——你不在现场，这是唯一的刹车。