WorkBuddy状态异常时，需依次启用内置状态看板、验证Claw Webhook可用性、配置系统级服务守护、接入企微告警、启用本地日志关键词扫描。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已安装WorkBuddy但无法确认其运行状态、任务执行是否持续在线或远程指令是否被正常接收，则可能是由于监控机制未启用或Claw服务未正确绑定。以下是实现WorkBuddy部署后实时状态可视与异常响应的配置步骤：
一、启用内置运行状态面板
WorkBuddy客户端主界面右下角默认显示系统托盘图标，点击可唤出实时运行看板，该看板直接反映本地Agent活跃度、Claw连接状态及最近3条任务执行日志，无需额外部署外部监控组件。
1、启动WorkBuddy客户端，确保右下角任务栏出现蓝色龙虾图标。
2、右键点击该图标，在弹出菜单中选择【打开主界面】。
3、在主界面底部工具栏中，点击【状态看板】按钮。
4、查看“Claw连接”项：若显示已连接且右侧有实时心跳脉冲动画，则表示远程控制通道畅通；若显示断开，需进入下一步排查。
二、验证Claw Webhook端点可用性
Claw依赖Webhook URL作为企业微信等IM平台向本地WorkBuddy投递指令的唯一入口，该URL由WorkBuddy动态生成并绑定至本地HTTP服务，必须确保其可被公网IM服务器访问且未被系统防火墙拦截。
1、在WorkBuddy设置中心，进入【Claw集成】→【企微AIBot】页面。
2、确认“Webhook URL”字段已生成非空值，格式为https://[随机字符串].claw.codebuddy.cn/xxx。
3、复制该URL，在手机企业微信中新建测试消息，发送任意自然语言指令（如“你好”）。
4、返回WorkBuddy主界面，观察对话区域是否在5秒内自动弹出响应；若无响应，检查Windows防火墙或macOS“完全磁盘访问”权限是否已授予WorkBuddy。
三、配置系统级服务健康检查
针对需7×24小时值守的办公场景，可通过操作系统原生服务管理机制对WorkBuddy进程实施守护，当进程意外退出时自动重启，并记录系统事件日志供回溯。
1、Windows用户：打开PowerShell（管理员模式），执行命令：sc create WorkBuddyGuard binPath= "C:\Program Files\WorkBuddy\WorkBuddy.exe" start= auto。
2、执行命令：sc failure WorkBuddyGuard actions= restart/60000/restart/60000/restart/60000 reset= 86400，设定三次失败后每60秒重启，86400秒后重置计数器。
3、macOS用户：在终端中执行：launchctl load -w ~/Library/LaunchAgents/com.tencent.workbuddy.plist，该plist文件需预先按Apple官方格式定义KeepAlive与StandardOutPath参数。
四、接入企业微信管理后台告警
企业微信管理后台提供机器人消息送达率与API调用错误码统计功能，可将Claw绑定的智能机器人纳入组织级监控体系，实现跨设备、跨账号的统一异常感知。
1、登录企业微信管理后台，进入【应用管理】→【智能机器人】→选择已绑定WorkBuddy的机器人。
2、点击【数据统计】标签页，开启“消息送达失败告警”开关。
3、在【告警接收人】中添加管理员企业微信账号，设定触发阈值为单日失败次数≥3次。
4、保存后，当Claw服务连续无法响应IM指令时，管理员将收到含错误码（如404、502）与时间戳的图文告警消息。
五、启用本地日志归档与关键词扫描
WorkBuddy默认将所有任务执行过程写入本地结构化日志文件，通过定期扫描关键字段（如“ERROR”、“timeout”、“permission denied”），可快速定位环境级故障根源，避免依赖GUI界面人工排查。
1、定位日志路径：Windows为%APPDATA%\Tencent\WorkBuddy\logs\，macOS为~/Library/Logs/WorkBuddy/。
2、使用系统自带工具检查最新日志：Windows执行Get-Content (Get-ChildItem "$env:APPDATA\Tencent\WorkBuddy\logs\*.log" | Sort-Object LastWriteTime -Descending | Select-Object -First 1) -Tail 20 | Select-String "ERROR"。
3、macOS执行：tail -n 20 "$(ls -t ~/Library/Logs/WorkBuddy/*.log | head -1)" | grep ERROR。
4、若输出非空行，提取其中Error Code 107（权限不足）或Error Code 204（模型加载失败）等编码，对应查阅腾讯CodeBuddy文档故障代码表。
