WorkBuddy群消息无响应需按五步排查：一查Claw绑定与连接状态；二验触发关键词及消息格式；三确认群聊权限与机器人可见性；四检本地Skill加载与启用状态；五排网络代理与防火墙拦截。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在企业微信或微信群中发送消息，但WorkBuddy未响应或未触发预设技能，则可能是由于消息格式、权限配置或连接状态异常导致。以下是排查此问题的步骤：
一、检查Claw绑定与连接状态
Claw是WorkBuddy的远程控制通道，群消息触发依赖于Claw与本地WorkBuddy的稳定通信。若绑定失效或连接中断，所有群指令将无法抵达桌面端。
1、打开WorkBuddy客户端，点击右上角个人中心 → 进入「Claw设置」界面。
2、确认当前已启用的通讯工具图标显示为绿色在线状态；若为灰色或提示“断连”，点击「重连」按钮。
3、在手机端对应群聊中发送测试指令，如“你好”，观察电脑端是否弹出响应气泡或日志提示。
二、验证群消息触发关键词与格式
WorkBuddy默认仅对符合特定结构的消息启动技能解析，非标准格式（如纯表情、过短无动词、含屏蔽词）将被直接忽略。
1、确保消息以支持的触发前缀开头，例如“@WorkBuddy”或“/wb”（需在Claw设置中开启“群内@触发”选项）。
2、指令内容须包含明确动作动词与操作对象，例如“@WorkBuddy 把上周销售表合并成PDF”；避免使用模糊表述如“帮我弄一下”。
3、检查消息中是否混入不可见字符、换行符或Markdown语法，此类内容可能导致解析器截断失败。
三、确认群聊权限与机器人可见性
企业微信/飞书等平台对群机器人设有严格权限管控，若WorkBuddy未被赋予“可接收群消息”或“可@全员”权限，则无法捕获非直呼类指令。
1、在企业微信管理后台进入对应群组 → 「群机器人」→ 找到WorkBuddy机器人 → 点击「编辑」。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、勾选“允许被@”与“接收群消息”两项权限。
3、返回群聊，发送“@WorkBuddy status”，验证是否返回运行状态摘要（含CPU占用、技能加载数、最后心跳时间）。
四、检查本地Skill加载与启用状态
即使消息成功送达，若目标技能未加载、被禁用或存在语法错误，WorkBuddy仍将跳过执行并静默丢弃。
1、在WorkBuddy主界面左下角点击「Skills」标签页，查看列表中目标技能右侧状态图标。
2、确认该技能显示为“已启用”且版本号非“0.0.0”或“error”。
3、点击技能名称右侧的「调试」按钮，在弹出窗口中粘贴原始群消息内容，点击「模拟触发」，观察控制台是否输出解析路径与报错信息。
五、排查网络代理与防火墙拦截
Claw通信采用HTTPS长链接，默认走系统代理；若企业网络启用了深度包检测（DPI）或白名单机制，可能阻断WorkBuddy心跳包或指令回传。
1、在Claw设置页底部点击「网络诊断」，运行连通性检测，重点关注“wss://claw.codebuddy.cn”连接延迟与TLS握手结果。
2、临时关闭本地防火墙或安全软件，重新发送测试指令，对比响应变化。
3、若使用公司代理，进入Claw设置 → 「高级网络」→ 手动填写代理地址与端口，并勾选“强制使用系统代理”。
