WorkBuddy如何接入QQ机器人_WorkBuddy对接QQ实现自动回复指南

问题出在QQ机器人未注册、密钥未填入或Webhook未生效；需依次完成QQ开放平台实名认证、创建机器人获取AppID/AppKey/Token、WorkBuddy中配置参数、设置Webhook回调地址并启用消息权限、最后通过QQ发送消息验证自动回复。

如果你已经顺利安装并登录了WorkBuddy客户端，但在QQ里和AI智能体的对话却石沉大海，没有得到任何自动回复，别急，问题通常锁定在三个环节：要么是QQ机器人没“上户口”，要么是通信密钥对不上，再不然就是那条关键的消息通道——Webhook——还没打通。

接下来，咱们就按图索骥，把这条从QQ到WorkBuddy的通信链路从头到尾捋顺。只要一步步走下来，双向通信和自动回复功能就能手到擒来。

一、注册QQ开放平台账号并实名认证

想玩转QQ机器人，第一步就得先拿到“官方认证”。这相当于给你的机器人在腾讯系产品里办一张合法身份证，没有它，后面的一切都无从谈起。

1、最快捷的方式，直接用手机QQ扫描平台提供的二维码，快速完成开发者账号的注册流程。

2、根据页面指引，如实填写主体信息。个人用户选择“个人”类型，并按要求完成实名认证。这一步是为了确保开发者的可追溯性。

3、认证审核通过后，你的账号就算正式激活了。这时，系统会自动跳转到开发者控制台首页，准备工作就此完成。

二、创建QQ机器人并获取基础凭证

有了账号，接下来就是“创造”你的机器人了。这个过程会生成三组核心密钥：AppID、AppKey和Token。它们就像是机器人的唯一ID和 secret handshake（秘密握手信号），是后续WorkBuddy识别并与之安全通信的绝对前提。

1、访问QQ机器人的官方创建入口：https://q.qq.com/qqbot/openclaw/index.html。

2、点击“立即创建”，给你的机器人起个名字、选个头像，确认后即可完成创建。

3、创建成功后，进入机器人的详情管理页面。这里需要你像个特工一样，准确无误地抄下三项关键信息：AppID、AppKey、以及Token（如果已配置）。建议直接复制粘贴，避免手动输入出错。

三、在WorkBuddy中填写QQ集成参数

拿到密钥，下一步就是让本地的WorkBuddy客户端和你刚刚在云端创建的机器人“相认”。这一步的核心，是把上一步复制的凭证，准确填入WorkBuddy的配置后台，建立可信的绑定关系。

1、打开你的WorkBuddy客户端，点击右上角的头像，进入「Claw 设置」界面。

2、在「集成」应用列表里，找到「QQ机器人」这个选项，点击右侧的「配置」按钮。

3、在弹出的配置窗口中，依次粘贴你刚刚保存好的AppID、AppKey、Token，然后点击「保存」。至此，客户端的配置工作就完成了。

四、配置Webhook回调地址并开启权限

如果说密钥是身份证明，那么Webhook就是专用的消息快递通道。光有身份不行，还得告诉QQ平台：“有消息请送到这个地址。” 这个地址由WorkBuddy生成，必须在QQ后台准确配置并开启权限，否则用户发给机器人的消息根本无法触发自动回复流程。

1、完成上一步保存后，WorkBuddy会自动生成一个唯一的Webhook地址，格式通常类似https://[xxx].codebuddy.cn/webhook/qq/[uuid]。这个地址非常重要。

2、再次回到QQ开放平台的机器人管理页面。找到「机器人设置」下的「Webhook配置」栏目。

3、将WorkBuddy生成的专属地址，完整无误地填入「回调URL」输入框。接着，务必要勾选上「消息事件」的接收权限，最后，点击那个至关重要的「启用Webhook」按钮。看到状态变成绿色的“已启用”，才意味着这条快递专线正式开通了。

五、验证自动回复功能是否就绪

配置全部完成后，是骡子是马，得拉出来遛遛。最后一步就是进行端到端的真实测试，验证从消息接收、AI智能体解析、到执行回复的整个闭环是否畅通无阻。

1、打开你的手机QQ，搜索并添加刚刚创建好的那个机器人账号为好友。

2、向它发送任意一条消息，比如简单的“你好”，或者问一句“现在几点”。

3、同时观察两个地方：一是查看WorkBuddy客户端底部的状态栏，是否出现了“收到QQ消息：[你发送的内容]”的提示；二是看QQ聊天窗口里，机器人是否在几秒内给出了智能回复。如果两者都满足，那么恭喜你，全链路贯通，自动回复功能已经正式就绪！