问题源于Agent与Claw通道心跳异常，需依次验证Agent响应性、调整服务端心跳阈值、清除本地会话缓存，并支持直连自检。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WorkBuddy客户端中看到成员状态显示为“离线”，但本地Agent进程实际正在运行，则问题很可能源于Agent服务端与Claw通道之间的心跳检测异常。心跳信号中断将导致服务端误判为失联，从而触发离线标记。以下是修复此问题的多种方法：
一、验证Agent进程是否真实响应心跳请求
Agent必须持续接收并及时响应来自Claw服务端的ping探测，若因线程阻塞、模型加载卡顿或GC暂停导致pong延迟超时，服务端将主动标记为离线。需确认其底层通信线程处于活跃可响应状态。
1、Windows用户按Ctrl+Shift+Esc打开任务管理器，在“详细信息”页签中查找“agent.exe”，右键选择“转到服务”，确认关联服务状态为“正在运行”且CPU使用率非零。
2、macOS用户打开“活动监视器”，搜索“agent”，双击进程查看“打开文件和端口”标签页，确认存在监听地址为127.0.0.1:8081（默认Claw Agent端口）的TCP连接。
3、在终端中执行命令：curl -X GET http://127.0.0.1:8081/health，若返回JSON中"status": "up"且"ping_latency_ms"小于3000，表明心跳链路正常；若超时或返回503，说明Agent未就绪。
二、检查Claw服务端心跳配置与超时阈值匹配性
Claw服务端对Agent的心跳响应设定了严格的时间窗口（默认3秒），若Agent所在设备存在高负载、磁盘IO瓶颈或网络代理干扰，可能导致偶发性pong延迟，被服务端连续判定为失败并降级为离线。
1、打开WorkBuddy主界面，点击右上角个人中心 → Claw设置 → 企微AIBot → 高级选项。
2、找到heartbeat_timeout_ms字段，将其值从默认3000调整为5000以容纳瞬时延迟。
3、在同一页面修改heartbeat_interval_ms为15000（即每15秒发起一次探测），降低高频探测引发的资源争抢。
4、点击【保存并重启Claw服务】，等待约10秒后观察成员状态栏是否由灰色转为蓝色脉动。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、强制重置Agent本地心跳会话缓存
Agent在异常退出或强制杀进程后，可能残留未清理的WebSocket握手状态或心跳计时器句柄，导致新启动实例无法注册到Claw服务端心跳列表，始终无法被识别为在线。
1、关闭WorkBuddy主程序及所有相关进程（包括agent.exe、workbuddy.exe、claw-gateway）。
2、删除Agent运行时缓存目录：%APPDATA%\WorkBuddy\agent\session_cache\（Windows）或~/Library/Caches/WorkBuddy/agent/session_cache/（macOS）。
3、重新启动WorkBuddy，等待主界面右下角图标稳定显示后，右键托盘图标选择【重启Agent服务】。
4、在企业微信中向机器人发送指令：/status，确认返回消息中包含“Agent心跳已注册”字样。
四、绕过Claw服务端直连Agent进行心跳自检
当Claw服务端本身出现路由异常或DNS解析故障时，Agent虽运行正常却无法上报状态。此时可通过本地HTTP接口直接触发心跳自检，验证Agent独立健康度，排除服务端依赖。
1、确保Agent进程正在运行，且端口8081未被占用。
2、在浏览器地址栏输入：http://127.0.0.1:8081/debug/ping，页面应立即返回{"pong":"true","timestamp":1745042012345}。
3、若返回空白页或连接被拒绝，说明Agent未监听该端口；若返回{"pong":"false"}，则表示内部心跳模块未激活，需进入调试面板手动启用。
4、按下Ctrl+Shift+D（Windows/Linux）或Cmd+Shift+D（macOS）打开调试面板，在控制台输入：window.agentCore?.startHeartbeat()并回车。
