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

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

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您已安装并登录WorkBuddy客户端，但尚未在QQ中实现与AI智能体的双向通信与自动回复，则问题可能出在QQ机器人未完成注册、密钥未正确填入或Webhook未生效。以下是接入QQ机器人并启用自动回复功能的具体操作路径：

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

该步骤是获取合法机器人身份的前提，必须通过腾讯官方渠道完成开发者资质验证，否则后续无法生成有效AppID与密钥。

1、使用手机QQ扫描二维码，快速完成QQ开放平台开发者账号注册。

2、按页面提示填写主体信息，个人用户选择“个人”类型，完成实名认证流程。

3、认证通过后，系统自动激活账号，返回控制台首页。

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

创建机器人将生成唯一标识和通信密钥，这些凭证是WorkBuddy识别并安全连接该机器人的必要凭据。

1、访问QQ机器人创建页面：https://q.qq.com/qqbot/openclaw/index.html。

2、点击“立即创建”，为机器人设置名称与头像，确认创建。

3、在机器人详情页中，完整复制以下三项值：AppID、AppKey、Token（如已配置）。

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

此步骤将本地运行的WorkBuddy与云端QQ机器人建立可信绑定关系，确保指令可下发、消息可回传。

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

Seed-Music

字节跳动推出的AI音乐生成与编辑工具

下载

2、在「集成」列表中找到「QQ机器人」选项，点击右侧「配置」按钮。

3、依次粘贴此前复制的AppID、AppKey、Token，点击「保存」。

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

Webhook是QQ平台向WorkBuddy推送用户消息的唯一通道，必须准确填写且权限需手动启用，否则无法触发自动回复逻辑。

1、保存QQ集成参数后，WorkBuddy自动生成专属Webhook地址，格式为https://[xxx].codebuddy.cn/webhook/qq/[uuid]。

2、返回QQ开放平台机器人管理页，在「机器人设置」→「Webhook配置」中，将上述地址完整填入「回调URL」栏。

3、勾选「消息事件」权限，并点击「启用Webhook」按钮，状态变为绿色“已启用”即表示成功。

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

该步骤通过真实消息交互确认全链路是否贯通，包括消息接收、AI解析、指令执行与结果回传四个环节。

1、在手机QQ中搜索并添加刚创建的机器人账号。

2、向该机器人发送任意文本，例如“你好”或“当前时间”。

3、观察WorkBuddy客户端底部状态栏是否显示“收到QQ消息：[内容]”，并查看聊天窗口是否即时返回响应。