EZ Cronjob

修复 Clawdbot/Moltbot 常见的 cron 任务故障:消息投递问题、工具超时、时区 bug、模型回退问题。

安装

概览

什么是EZ Cronjob

EZ Cronjob 是一个专为 Clawdbot/Moltbot 设计的 cron 任务可靠性指南,旨在解决生产环境中常见的定时任务故障问题。该工具通过系统化的诊断方法和最佳实践,帮助用户快速定位并修复消息投递失败、工具超时、时区错误以及模型回退异常等典型问题。其核心理念是提供一套经过实战验证的“黄金规则”,确保即使在复杂环境下也能实现稳定可靠的自动化消息调度。无论是日常提醒还是周期性报告,EZ Cronjob 都强调使用标准化参数组合和调试命令来规避潜在陷阱。

核心功能特点

  1. 提供完整的 cron 任务故障诊断流程与解决方案
  2. 强制要求使用 `–session isolated` 防止消息丢失
  3. 必须显式指定时区(如 `–tz “Asia/Shanghai”`)避免 UTC 混淆
  4. 推荐嵌入 `[INSTRUCTION: DO NOT USE ANY TOOLS]` 指令以兼容降级模型
  5. 禁止使用内置 `cron` 工具而改用 `exec` 执行命令行调用
  6. 集成实时日志监控与网关重启等高级调试手段

适用场景

EZ Cronjob 特别适用于需要高可靠性的企业级自动化场景,例如每日晨会提醒、周报汇总或客户通知等关键业务流程。在这些场景中,即使单次消息延迟也可能造成沟通断层或运营中断,因此必须依赖严格的参数配置和隔离会话机制来保障交付成功率。对于跨国团队而言,正确设置时区标识尤为重要——未指定时区会导致北美东部时间凌晨 9 点的任务在北京时间凌晨 2 点触发,严重影响用户体验。此外,在备用模型性能较弱的情况下,仅靠系统提示无法约束其行为,必须将‘禁止调用工具’的指令直接写入消息内容本身。通过结合 `–best-effort-deliver` 标志,即便遇到瞬时网络波动也不会导致整个任务链崩溃,而是允许优雅降级处理。总之,任何涉及重要信息传递的定时作业都应遵循此指南中的规范进行部署与测试。