问题出在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 设置」。
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消息:[内容]”,并查看聊天窗口是否即时返回响应。











