Cron Mastery

核心定位

Cron Mastery 是 OpenClaw 生态中时间管理的基础设施级技能，专为解决 AI 助手中普遍存在的"漂移提醒"问题而设计。其核心贡献在于建立了 Heartbeat（宽松轮询） 与 Cron（精确调度） 的严格区分原则，让时间敏感型任务（如5分钟后提醒）获得可靠保障。

显著优点

1. 精确性保障：明确 Cron 的 at 调度可做到秒级精度（受网关心跳10-60s影响），彻底告别 Heartbeat 30-60分钟漂移导致的"错过提醒"
2. 推送通知原生支持：2026.2.15+ 版本通过 agentTurn + announce 模式实现真正的手机 Push 通知，而非仅注入聊天记录的静默日志
3. 自动化运维：单次任务支持 deleteAfterRun: true 自动清理，告别手动"捉鬼"维护
4. 严格的模式区分：systemEvent（静默日志）vs AgentTurn（主动唤醒）的选择指南清晰可执行
5. 向后兼容的迁移路径：提供 Legacy → Modern 的完整对照表，降低版本升级成本

潜在局限与风险

• 网关依赖：Cron 精度受网关心跳间隔（10-60s）制约，极端场景下仍有 ~30s 方差
• 时区刚性要求：必须在 MEMORY.md 中锁定用户时区，否则"晚上9点"可能歧义
• 并发历史包袱：虽已修复 Add-then-Update 死锁，但复杂场景仍需注意 wakeMode: "now" 显式声明
• 学习曲线：Strict Instruction Pattern 的格式要求（全大写指令前缀）对新手不够直观

适合人群

• 需要可靠提醒功能的终端用户（医疗用药、会议闹钟等场景）
• 构建自动化工作流的开发者（日报生成、系统巡检）
• 从旧版本（<2026.2.15）迁移存量 Cron 任务的维护者

常规风险提示

S级（最高）风险：误用 systemEvent 替代 agentTurn 将导致关键提醒静默失效，在医疗、金融等场景可能造成实质损失。务必按文档"CRITICAL"标注执行模式选择。

A级风险：时区未锁定时的跨午夜调度错误，建议强制校验环节纳入交互流程。

核心功能与用法

Cron Mastery 是 OpenClaw 2026.2.15+ 版本的定时任务管理指南，核心解决「提醒失效」问题——通过严格区分 Heartbeat（心跳检测） 与 Cron（定时调度） 两种机制。

| 机制 | 行为 | 适用场景 |

|:---|:---|:---|

| **Heartbeat** | "有空时检查"（30-60分钟间隔） | 邮件检查、新闻摘要、低优先级轮询 |

| **Cron** | "精确在X时刻执行" | 即时提醒、每日报告、系统维护 |

关键用法

1. 可靠提醒设置（2026.2.15+ 标准）

• 禁止用 act:wait 处理>1分钟延迟
• 使用 cron:add + at 一次性调度
• 推送通知：agentTurn + 严格指令模式（DELIVER THIS EXACT MESSAGE...）+ announce 模式
• 静默日志：systemEvent 注入聊天历史，无手机推送

2. 关键配置参数

• deleteAfterRun: true：一次性任务自动清理（v2026.2.15+ 内置）
• sessionTarget: "isolated"：默认隔离会话
• sessionTarget: "main"：仅系统维护任务使用（完整工具权限）
• wakeMode: "now"：确保任务唤醒执行

3. 时区锁定
必须在 MEMORY.md 中记录用户时区（如 Cairo (GMT+2)），确认「晚上9点」指代明确。

显著优点

• 精确性：Cron 消除 Heartbeat 漂移问题，适合时间敏感任务
• 自动化：一次性任务自动清理，告别「幽灵任务」
• 稳定性：v2026.2.15+ 解决 nextRunAtMs 损坏和「添加-更新」死锁
• 灵活性：支持 at（精确时刻）与 every（周期性）两种调度模式

潜在缺点与局限性

• 执行方差：实际执行依赖 Gateway Heartbeat（10-60秒），可能产生~30秒延迟
• 配置复杂：推送通知需严格遵循 agentTurn + 指令模式，误用 systemEvent 导致静默失败
• 权限陷阱：子代理（isolated）无法删除 Cron 任务，维护任务必须用 main 会话
• 版本依赖：大量功能（自动清理、稳定性修复）要求 2026.2.15+，旧版本需手动迁移

适合人群

• OpenClaw 用户：需要可靠提醒、定时报告、系统维护的开发者
• 迁移用户：从旧版本升级，需更新 atMs → ISO 8601、deliver → announce 等配置
• 自动化爱好者：构建个人工作流、健康提醒、数据备份等周期性任务

常规风险

• 静默失败：误用 systemEvent 替代 agentTurn 导致提醒不发推送
• AI 画蛇添足：未使用严格指令模式，子代理添加冗余评论
• 时区混乱：未锁定时区导致跨地区提醒时间错误
• 并发误操作：虽 v2026.2.15+ 已稳定，仍建议单步 cron.add 避免历史死锁模式