解决 Clawdbot/Moltbot 定时任务常见故障：消息丢失、时区错误、工具死锁、模型回退异常等问题
说明：
## 技能概述
`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` 规避 |
| 模型违规 | 低 | 回退模型可能无视指令调用工具，需持续监控 |
会员专属
