定时任务故障排查完全指南

解决 Clawdbot/Moltbot 定时任务常见故障：消息丢失、时区错误、工具死锁、模型回退异常等问题

基本信息

• 技能名称?EZ Cronjob
• 中文名称?定时任务故障排查完全指南
• 作者?promadgenius
• 分类?专业技能
• 版本?1.0.0
• 标签?cron, scheduling, telegram, debugging, moltbot, clawdbot, devops, reliability

使用方法

使用说明
技能概述
ez-cronjob 是一份面向 Clawdbot/Moltbot 用户的生产级定时任务故障排查指南，由 Isaac Zarzuri 基于实际运维经验编写，专注解决 cron 任务调度中的五大核心痛点。
核心用法
该技能不依赖代码执行，而是以文档形式提供经过验证的命令模板与排障流程。主要覆盖五个典型场景：

1. 避免 cron 工具死锁 ：使用 exec: clawdbot cron 替代直接调用 cron 工具，绕过 agent 与 gateway 间的 10 秒超时死锁
2. 确保消息可靠投递 ：强制使用 --session isolated 防止主会话冲突导致的消息丢失
3. 消除时区混乱 ：显式指定 --tz 参数（如 America/New_York ），避免 UTC 默认导致的执行时间偏差
4. 控制回退模型行为 ：在消息体前置 [INSTRUCTION: DO NOT USE ANY TOOLS] 指令，防止小模型违规调用工具
5. 故障诊断与恢复 ：提供日志查询、gateway 重启、作业重建等完整运维流程
   显著优点
   实战验证 ：所有方案均来自生产环境调试，非理论推导
   即查即用 ：提供可直接复制的命令模板，降低配置错误率
   防御性设计 ：通过 --best-effort-deliver 等参数实现优雅降级
   多场景覆盖 ：从周期性提醒到一次性任务均有完整示例
   局限性与风险
   生态锁定 ：完全针对 Clawdbot/Moltbot 生态，无法迁移至其他 cron 系统
   时效性依赖 ：随着平台版本迭代，部分命令语法可能失效
   无自动修复 ：纯文档技能，不具备自动诊断或修复能力，仍需人工执行
   回退模型问题 ：指令嵌入方案虽有效，但依赖模型对自然语言指令的遵循度
   适合人群
   使用 Clawdbot/Moltbot 进行 Telegram/WhatsApp 自动化的开发者
   需要配置可靠定时提醒、日报、周报等场景的团队管理员
   遭遇消息丢失、时区错误等疑难杂症的运维人员
   常规风险
   | 风险点 | 等级 | 说明 | |--------|------|------| | 消息丢失 | 中 | 未使用 --session isolated 时，主会话繁忙可能导致投递失败 | | 时间漂移 | 中 | 缺少时区参数导致 UTC 与本地时间偏差 | | 工具死锁 | 低 | 直接调用 cron 工具触发 10 秒超时，但可通过 exec 规避 | | 模型违规 | 低 | 回退模型可能无视指令调用工具，需持续监控 |