（10822期）EZ Cronjob – 定时任务故障排查完全指南

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