qq账号未绑定导致workbuddy无法响应手机qq指令，需依次完成登录、开启claw远程控制、配置qq机器人凭证、设置webhook回调、扫码授权个人qq账号五步操作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果你正在电脑上运行WorkBuddy，但手机QQ发来的指令始终无法触发远程操作，说明QQ账号尚未完成绑定——这一步缺失会导致WorkBuddy完全收不到QQ消息，也无法执行“发消息给张三”“截图当前窗口”等遥控指令。
确认WorkBuddy已登录并启用Claw服务
WorkBuddy必须以登录态运行，且Claw远程控制模块处于激活状态，否则后续所有绑定操作都无效。未登录时界面右下角状态图标为灰色空心圆点，此时点击任何集成配置都会提示“请先登录”。【未登录状态下无法生成Webhook地址，也无法跳转QQ授权页】
打开WorkBuddy客户端 → 输入手机号+短信验证码完成登录 → 等待右下角状态栏变为绿色实心圆点 → 点击右上角头像 → 进入「Claw 设置」→ 确保「远程控制总开关」已开启（滑块为蓝色）。
在Claw中开启QQ集成并获取凭证
QQ远程遥控不是默认启用的功能，需手动开启服务模块并填入腾讯官方发放的合法凭证，否则系统不会加载QQ通信协议适配器。
方法一：快速绑定（适用于已有QQ机器人）
进入「Claw 设置」→「集成」列表 → 找到「QQ机器人」→ 点击「配置」→ 粘贴AppID、AppKey、Token → 点击「保存」→ 自动生成Webhook地址。
方法二：从零创建机器人（首次使用QQ开放平台）
① 访问QQ机器人创建页 → 扫码登录 → 点击「立即创建」→ 填写名称（勿含特殊符号）、上传头像、简要描述 → 提交审核；
② 审核通过后，进入机器人详情页 → 在「开发管理」中复制AppID → 点击AppSecret旁「生成」按钮 → 【务必立即复制并保存AppSecret，该密钥仅显示一次，丢失后需重置，旧密钥立即失效】；
③ 返回WorkBuddy「QQ机器人配置」界面 → 依次填入三项凭证 → 保存。
配置Webhook回调并启用消息权限
Webhook是QQ向WorkBuddy推送消息的唯一通道，地址填错、权限未勾选或未点击启用，都会导致“绑定成功”但实际收不到任何消息。
复制WorkBuddy生成的Webhook地址（格式如https://xxx.codebuddy.cn/webhook/qq/uuid）→ 登录QQ开放平台 → 进入对应机器人管理页 → 左侧菜单选择「Webhook配置」→ 将完整地址粘贴至「回调URL」栏 → 勾选「消息事件」→ 点击「启用Webhook」→ 状态显示绿色“已启用”即生效。
注意：回调URL必须包含https://前缀，且不能手动删减路径中的/webhook/qq/uuid部分，否则QQ服务器无法定位到你的WorkBuddy实例。
完成QQ账号扫码授权
这一步建立的是WorkBuddy与你个人QQ账号之间的操作授权关系，和机器人身份无关，它决定AI能否以你的名义发送消息、唤起窗口、读取聊天记录。
回到WorkBuddy主界面 → 左上角菜单栏【设置】→【扩展服务】→ 找到「QQ远程控制」→ 将滑块拖至开启 → 弹出窗口点击【立即授权】→ 跳转至腾讯OAuth 2.0授权页 → 用手机QQ扫描二维码 → 在确认弹窗中【只勾选“远程消息接收与基础操作”，绝对不要勾选“文件上传”或“联系人管理”】→ 点击【确认授权】→ 网页显示“绑定成功”，客户端状态同步更新为“已连接QQ账号”。
