WorkBuddy功能异常时，需依次排查：一、确认客户端进程运行及在线状态；二、检查远程通道绑定与心跳；三、授予文件系统访问权限；四、诊断模型服务连接与API配额；五、重置Claw核心服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy过程中遇到功能异常、响应延迟、指令无反馈或远程控制失效等情况，则可能是由于本地配置错误、服务连接中断或权限未正确授予所致。以下是针对常见故障的快速排查操作详解：
一、验证本地客户端运行状态
WorkBuddy必须在本地电脑后台持续运行才能响应指令，若进程意外退出或被系统终止，将导致所有功能不可用。需确认其是否处于活跃运行状态，并具备必要系统权限。
1、打开任务管理器（Windows）或活动监视器（macOS），搜索“WorkBuddy”进程。
2、若未发现该进程，双击桌面快捷方式或从开始菜单/启动台重新启动。
3、启动后观察右下角系统托盘（Windows）或菜单栏（macOS）是否出现WorkBuddy图标。
4、右键图标选择“显示主界面”，确认登录状态为已登录且显示在线。
二、检查远程通道绑定状态
企业微信、QQ、飞书等远程控制通道需完成一次性绑定，若绑定失效或Token过期，手机端指令将无法抵达本地客户端。需逐项核验各通道的连接有效性。
1、打开WorkBuddy主界面，点击右上角个人中心 → Claw设置。
2、在“通讯工具”列表中，查看已启用通道旁的标识：绿色对勾表示已激活且心跳正常，灰色感叹号表示断连。
3、对断连通道，点击“重新绑定”，按提示在手机端扫码并确认授权。
4、绑定完成后，在手机对应App中向机器人发送“测试”二字，观察电脑端是否弹出响应提示框。
三、确认本地文件系统访问权限
WorkBuddy执行文件操作（如读取Excel、重命名文档）前，必须获得操作系统明确授权。Windows Defender或macOS隐私设置可能自动撤回权限，导致任务卡在“准备阶段”。
1、Windows用户：进入“设置 → 隐私和安全性 → 文件系统”，查找WorkBuddy条目，确保桌面、文档、下载、D盘等目标路径开关均为开启。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
2、macOS用户：进入“系统设置 → 隐私与安全性 → 完全磁盘访问”，点击左下锁图标解锁，拖入WorkBuddy.app并勾选。
3、重启WorkBuddy客户端，使新权限立即生效。
四、校验模型服务连接与API可用性
指令解析与任务规划依赖后端AI模型服务，若模型API不可达或配额耗尽，将出现“正在思考…”长时间无响应或报错“模型调用失败”。需定位是网络问题还是配额/配置问题。
1、在WorkBuddy主界面底部状态栏，查看右侧模型图标旁是否显示混元/DeepSeek/GLM等名称及绿色在线标识。
2、若显示“离线”或“限流中”，点击该图标，选择“诊断模型连接”。
3、运行诊断后，查看输出日志中是否含“HTTP 200”或“quota exceeded”字样。
4、若为配额问题，登录CodeBuddy控制台 → 用量管理，确认5000 Credits是否已成功领取并剩余充足。
五、重置Claw核心服务组件
Claw是WorkBuddy的任务调度与沙箱执行引擎，其内部状态异常（如任务队列阻塞、插件加载失败）会导致整套自动化流程停滞。重置可清空临时状态而不影响账号与配置。
1、关闭WorkBuddy主程序（非仅关闭窗口，需在托盘/菜单栏选择“退出”）。
2、按住键盘Shift键不放，同时双击桌面WorkBuddy图标重新启动。
3、弹出高级选项窗口后，勾选“重置Claw服务并清除运行缓存”，点击确定。
4、等待约15秒，界面自动刷新并显示“Claw已重启，就绪”提示。
