若WorkBuddy绑定QQ机器人失败，需依次核查：一、AppID/AppSecret是否准确且已重置；二、Webhook地址是否刷新并验证通过；三、QQ开放平台主体是否实名认证、机器人是否已上线；四、本地网络与Claw端口是否正常；五、是否清除Claw缓存后重试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已按流程配置WorkBuddy与QQ机器人，但始终显示“无法连接QQ”或“绑定失败”，则可能是由于AppID/AppSecret未正确填写、Webhook地址未生效、QQ开放平台回调未通过验证，或Claw服务未就绪所致。以下是多种可独立尝试的解决办法：
一、核验AppID与AppSecret输入准确性
WorkBuddy需精确识别QQ开放平台分配的凭证，任何空格、大小写错误或过期密钥均会导致鉴权失败。
1、重新登录QQ开放平台，进入对应机器人后台。
2、点击「开发管理」，确认AppID完整无缺，并手动复制而非手打该值。
3、在AppSecret栏点击「生成新密钥」按钮，务必重置并复制新生成的密钥，旧密钥不可复用。
4、返回WorkBuddy设置页，在Claw配置区域粘贴更新后的AppID与AppSecret，保存后重启WorkBuddy主程序。
二、检查并重置Webhook回调地址配置
QQ开放平台仅接受已通过验证的Webhook地址，若地址格式错误、域名未备案或HTTPS证书失效，将拒绝回调请求。
1、打开WorkBuddy客户端，切换至「Claw」Tab页，确保Claw服务状态显示为“运行中”（非灰色暂停图标）。
2、点击右上角「刷新Webhook」按钮，重新生成当前有效地址。
3、前往QQ开放平台机器人后台 → 「回调配置」页面，删除原有地址，粘贴新生成的Webhook URL，点击「保存并验证」。
4、等待平台返回绿色对勾提示；若提示“验证失败”，请确认WorkBuddy未被防火墙拦截，且本地端口8080未被占用。
三、确认QQ开放平台主体资质与机器人审核状态
未完成实名认证、主体信息待审核或机器人状态为“审核中/已驳回”，将导致所有接口调用被平台拒绝。
1、登录QQ开放平台，进入「我的应用」→「主体信息」，确认人脸识别已完成且状态为“已认证”。
2、在「机器人列表」中查看目标机器人，状态必须为“已上线”或“已发布”，非“草稿”或“审核中”。
3、如状态异常，返回「基本信息」页检查名称、头像、描述是否符合《QQ机器人内容规范》，修改后重新提交审核。
四、排查本地网络与Claw服务冲突
Claw依赖本地HTTP服务监听端口响应QQ平台回调，杀毒软件、代理工具或系统Hosts劫持可能中断通信链路。
1、关闭Windows Defender防火墙临时测试：控制面板 → Windows Defender 防火墙 → 启用或关闭防火墙 → 选择“关闭”。
2、检查是否启用全局代理（如Clash、Surge等），WorkBuddy必须运行在直连网络下，禁用代理后重启程序。
3、以管理员身份运行命令提示符，执行：netstat -ano | findstr :8080，若返回PID非WorkBuddy进程，则需终止占用进程或修改Claw端口。
4、在WorkBuddy设置中进入「Claw设置」→「高级」，勾选「启用调试日志」，触发一次绑定操作后查看日志中是否出现“404 Not Found”或“Connection refused”字样。
五、强制清除Claw本地缓存与凭证数据
残留的旧会话令牌或损坏的配置文件可能导致Claw持续使用失效凭证发起无效请求。
1、完全退出WorkBuddy进程（任务管理器中结束所有WorkBuddy相关进程）。
2、定位本地数据目录：%APPDATA%\WorkBuddy\claw\（Windows）或 ~/Library/Application Support/WorkBuddy/claw/（macOS）。
3、删除该目录下全部文件，保留claw文件夹本身不删。
4、重新启动WorkBuddy，进入Claw页，重新执行Webhook生成与QQ机器人绑定全流程。
