若微信中WorkBuddy告警延迟、缺失或未触发，需依次检查Claw连接状态、企业微信机器人长链接与权限、启用远程调试捕获payload、强制刷新手机通知通道。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在微信中配置了 WorkBuddy 告警通知，但发现消息延迟、缺失或未触发，则可能是由于 Claw 通道未激活、企业微信机器人权限不足或本地服务监听异常。以下是验证与提升告警实时性的具体操作步骤：
一、验证 Claw 连接状态与消息通道可用性
Claw 是 WorkBuddy 实现微信端双向通信的核心协议，其连接稳定性直接决定告警是否能即时触达。若托盘图标呈灰色或显示“离线”，则消息通道已中断，所有告警将被缓存而无法推送。
1、检查电脑端 WorkBuddy 托盘图标颜色：绿色表示 Claw 已就绪，红色表示连接失败，灰色表示未启动或后台被系统休眠终止。
2、右键点击托盘图标，选择「打开主界面」，确认当前处于 Claw 标签页且右上角显示「Claw 已连接」。
3、在微信中向已绑定的客服号发送任意文本（如“测试”），观察电脑端是否在 2 秒内自动切换至 Claw 标签页并显示该消息；若无响应，说明底层 WebSocket 链路未建立。
4、在电脑命令行执行 netstat -ano | findstr :8080（Windows）或 lsof -i :8080（macOS/Linux），确认 WorkBuddy 进程（PID）正在监听本地 8080 端口——该端口为 Claw 心跳与指令转发的默认通信端点。
二、校验企业微信机器人长链接模式与权限完整性
当使用企业微信作为告警通道时，短链接模式仅支持单向推送，无法接收任务完成回调，导致告警延迟甚至丢失；必须启用长链接并导入完整权限集，才能保障消息秒级抵达与状态同步。
1、登录企业微信管理后台，进入对应自建应用的「机器人」设置页，确认「连接方式」为 长链接，而非“普通链接”或“Webhook”。
2、在「权限管理」中点击「导入权限」，粘贴标准权限 JSON 并确认导入成功，重点核对字段中是否包含 "im:message:send_as_bot" 与 "im:message:update" ——前者控制告警发送权，后者确保消息可被动态刷新（如进度条更新）。
3、检查页面右上角是否显示「已发布」状态；若仍为「草稿」，点击「发布」按钮使权限立即生效。
4、在 WorkBuddy 的 Claw 设置中，重新输入 Bot ID 与 Secret 后点击「测试连接」，等待弹窗提示 “连接成功，心跳间隔：3000ms”。
三、启用远程调试开关并捕获原始告警 payload
通过微信触发的告警行为需经 Claw 协议解析、安全策略过滤、工作区路径注入等多层处理，任一环节阻塞均会导致延迟。启用远程调试可暴露原始消息结构与各阶段耗时，定位瓶颈节点。
1、在微信中向 WorkBuddy 客服号发送指令：/debug on。
2、WorkBuddy 桌面端右下角将弹出浮动通知，系统托盘图标旁显示 “远程调试已激活”。
3、立即在微信中发送一条告警触发指令（如“监控D:\报表\每日导出.xlsx变更并告警”），观察调试面板中是否在 ≤1.2秒 内出现带时间戳的 JSON payload 条目，含字段 "event_type":"file_watch_alert" 与 "trigger_source":"wechat"。
4、若 payload 显示但无后续响应，检查面板中 “安全模式判定” 行是否为 “ALLOWED”；若为 “BLOCKED”，说明该路径未加入白名单，需在 Claw 设置 → 高级配置 → 文件监控白名单中手动添加。
四、强制刷新系统通知通道（Android/iOS 专用）
手机端操作系统可能因省电策略限制后台网络活动，导致 Claw 推送消息被系统拦截或延迟唤醒。启用强提醒机制可绕过聊天窗口，直接触发系统级通知，确保告警不被折叠或静音。
1、在手机设置中找到「应用管理」→「WorkBuddy（微信客服）」→「通知权限」，开启 “允许通知” 与 “锁屏通知”。
2、Android 用户需额外进入「电池优化」设置，搜索“微信”，将微信设为 “不受限制”；iOS 用户需在「设置」→「微信」→「后台App刷新」中开启开关。
3、在微信中发送指令：/notify force，WorkBuddy 将立即向手机发送一条测试通知，含震动与铃声（若系统允许）。
4、若测试通知未响铃或无震动，返回手机「声音与触感」设置，确认 “通知声音” 与 “触感反馈” 已启用，并非仅针对特定 App 关闭。
