定时任务未执行或失败的五大原因：一、本地客户端未运行；二、远程通道绑定失效；三、文件系统权限缺失；四、ai模型服务异常或配额耗尽；五、暂存盘空间不足或路径不可写。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您设置了 WorkBuddy 定时任务，但到达预定时间后任务未执行或显示失败，则可能是由于本地客户端状态异常、远程通道断连、权限缺失、模型服务不可用等底层环节出现中断。以下是常见原因的逐项排查路径：
一、本地客户端未持续运行
WorkBuddy 定时任务依赖本地客户端常驻后台并保持活跃状态；若进程被系统终止、崩溃退出或未启动，所有定时触发将完全失效。
1、按下 Ctrl+Shift+Esc 打开 Windows 任务管理器，切换至“进程”页签。
2、在搜索框中输入 WorkBuddy，确认是否存在主进程（如 WorkBuddy.exe 或 claw-agent）。
3、若未查到进程，双击桌面快捷方式重新启动；启动后检查右下角系统托盘是否出现图标。
4、右键托盘图标选择“显示主界面”，验证登录状态是否为 已登录且在线。
二、远程通道绑定失效
企业微信、飞书、QQ 等远程控制通道需维持有效 Token 连接；Token 过期、扫码授权未完成或网络阻断均会导致指令无法抵达本地客户端，从而表现为定时任务“未触发”。
1、打开 WorkBuddy 主界面，点击右上角个人中心 → Claw 设置。
2、在“通讯工具”列表中，识别各通道旁标识：绿色对勾表示心跳正常，灰色感叹号表示已断连。
3、对断连通道，点击“重新绑定”，使用手机端对应 App 扫码并完成二次授权。
4、绑定后，在手机 App 中向机器人发送“测试”，观察电脑端是否弹出响应提示框。
三、文件系统访问权限被系统撤回
定时任务若涉及读写本地文件（如生成 Excel、解析 Word），必须获得操作系统明确授权；Windows Defender 或 macOS 隐私设置可能自动禁用权限，导致任务卡在“准备阶段”并静默失败。
1、Windows 用户进入“设置 → 隐私和安全性 → 文件系统”，查找 WorkBuddy 条目。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、确保目标路径开关全部开启：桌面、文档、下载、D盘等任务实际访问路径。
3、macOS 用户进入“系统设置 → 隐私与安全性 → 完全磁盘访问”，解锁后拖入 WorkBuddy.app 并勾选。
4、完成设置后，必须重启 WorkBuddy 客户端，否则新权限不生效。
四、AI 模型服务连接异常或配额耗尽
定时任务的指令解析、逻辑规划及结果生成高度依赖后端 AI 模型服务；若 API 地址不可达、认证失败、返回空响应或调用配额归零，将直接报错 AGENT_INVOKABLE_CUSTOM_MODEL_NOT_FOUND，且无重试机制。
1、在 WorkBuddy 主界面点击左下角“帮助” → “诊断工具” → “模型服务连通性测试”。
2、观察测试结果：若显示“连接超时”或“认证失败”，说明后端服务异常或本地配置错误。
3、检查主界面右上角是否显示 模型服务离线 提示条（红色背景）。
4、确认当前账号是否处于 订阅有效期内，并登录管理控制台查看模型调用配额剩余量。
五、暂存盘空间不足或路径不可写
定时任务执行过程中需使用暂存盘缓存中间数据；当所选磁盘剩余空间低于 8GB，或路径因权限/加密/挂载异常导致不可写，任务会在初始化阶段阻塞并中断，日志中常出现 IOError: No space left on device 或 Permission denied。
1、进入首选项 → 增效工具 → 暂存盘，查看当前设定路径。
2、手动打开该路径所在磁盘，确认剩余空间是否 大于 20GB。
3、若空间不足，点击“更改”按钮，选择另一块非系统分区（如 D:\WorkBuddy_Temp）。
4、勾选“清空原暂存盘残留缓存”，点击“确定”后等待状态栏提示 暂存盘重定向完成，再重启客户端。
