WorkBuddy 企业微信机器人不响应，通常不是“AI 没听懂”，而是电脑端未运行、接入方式不一致、机器人凭据失效或可使用成员范围不包含当前账号。先发一句简单测试消息，再按“电脑—模式—凭据—权限”逐层排查，比反复删除重建更快。
第一层：确认执行端真的在线
企微助理只是远程入口，任务实际由电脑上的 WorkBuddy 执行。电脑必须保持开机、网络可用，WorkBuddy 客户端处于运行状态，助理服务也已开启。锁屏不一定等于停止运行，但系统休眠、退出客户端、网络切换或被防火墙阻断，都会让机器人收不到任务。
先回到桌面端查看“设置—助理设置”中的企微集成状态，再观察是否出现新的远程任务记录。企微有消息、桌面端完全没有记录，优先查连接；桌面端收到任务却执行失败，再查模型、权限和工作目录。
第二层：两端必须选择同一种接入方式
企业微信 API 模式支持 WebSocket 长连接和 URL 回调。企业微信后台选择长连接，WorkBuddy 里也必须选择长连接；一端用回调、一端用长连接，配置看似完整也不会互通。普通场景优先使用长连接，因为只需 Bot ID 和 Secret，不必回填 Webhook 地址。
长连接注册失败时，重新复制 Bot ID 与 Secret，排除前后空格，并确认 Secret 没有被重新生成。私有化企业微信还要检查自定义 WebSocket 地址必须以 ws:// 或 wss:// 开头，且当前电脑能访问对应网关和端口。
第三层：检查机器人对谁可见
机器人创建成功不代表所有成员都能使用。管理员应在企业微信后台检查“可使用成员”，确认当前员工、部门或标签已被包含；在群聊使用时，还要确认机器人已加入对应群，并通过 @机器人发送指令。先用被明确授权的账号单聊测试，可以快速区分成员范围问题和连接问题。
最后再重绑，不要一开始就删机器人
若状态显示已断开，可先在 WorkBuddy 中解绑再重新注册。URL 回调模式还要核对 Token、Encoding-AESKey 和回填地址完全一致。恢复后依次测试“你好”、只读查询、生成一个临时文件，最后再测试修改或删除类操作。高风险任务需要人工确认，这是安全机制而非机器人卡死。保留原机器人配置到新连接验证成功，再清理旧配置，可避免团队入口同时中断。
