Cron Mastery

核心功能与定位

Cron Mastery 是 OpenClaw 2026.2.3+ 版本的官方时间管理系统技能，核心解决「提醒失效」问题，严格区分两种时间机制：

• Cron：精确到秒的硬调度，适用于提醒、日报、系统维护
• Heartbeat：松散轮询（30-60分钟间隔），适用于邮件检查、低优先级任务

显著优点

1. 推送通知可靠性：通过 agentTurn + Strict Instructions 模式确保消息直达用户手机，而非仅写入聊天历史
2. 自动清理机制：2026.2.14+ 版本内置维护重计算语义，一次性任务成功后自动删除，减少人工维护
3. 并发稳定性：2026.2.15+ 修复 nextRunAtMs 损坏和「Add-then-Update」死锁问题
4. 版本迁移指南：提供从旧版（pre-2026.2.3）到现代语法的完整对照表

潜在局限与风险

• 执行精度天花板：实际执行依赖 Gateway Heartbeat（10-60秒），存在约30秒方差
• 配置复杂度：推送通知需显式配置 channel 和 to 字段，遗漏会导致静默失败
• 时区依赖：必须维护 MEMORY.md 中的时区信息，否则跨时区提醒会出错
• Session 隔离成本：默认 sessionTarget: isolated 每次唤醒创建独立会话，可能丢失上下文

适合人群

• 需要精确提醒的终端用户（医疗用药、会议通知）
• 运维人员（周期性系统维护、日志轮转）
• 从旧版 OpenClaw 迁移的现有用户

常规风险

| 风险场景 | 缓解措施 |

|---------|---------|

| 提醒未触发 | 检查 `cron:list`，确认 `at` 为未来时间且格式为 ISO 8601 |

| 消息无推送 | 验证 `delivery` 含 `channel` 和 `to`，使用 `agentTurn` 而非 `systemEvent` |

| 消息含AI废话 | 使用严格提示模板：`"DELIVER THIS EXACT MESSAGE...WITHOUT MODIFICATION"` |

| Gateway 超时 | 避免 `cron.add` 后立即 `cron.update`，采用单步完整参数添加 |

核心功能

Cron Mastery 是 OpenClaw 2026.2.3+ 的定时任务管理权威指南，系统解决"心跳漂移导致错过提醒"的核心痛点。

核心用法

1. Cron vs Heartbeat 严格区分

• Heartbeat：30-60分钟异步检查，适合邮件、新闻摘要等低优先级场景，但存在时间漂移风险
• Cron：精确到秒的定时执行，适合提醒、日报、系统维护等时间敏感任务

2. 可靠提醒模式（2026.2.15+）

• 使用 agentTurn + Strict Instructions 实现推送通知（手机弹窗）
• 使用 systemEvent 仅做静默日志记录
• 关键参数：wakeMode: "now" 确保即时唤醒，deleteAfterRun: true 自动清理

3. 时区锁定机制

• 必须将用户时区写入 MEMORY.md（如 "Cairo GMT+2"）
• 所有时间指令需确认时区，避免跨时区调度错误

显著优点

• 零漂移保证：Cron 精确到秒级执行，彻底解决心跳累积误差
• 自动运维：v2026.2.14+ 内置维护语义，自动清理僵死任务
• 推送可靠：AgentTurn 模式确保 Telegram/WhatsApp 消息必达
• 安全纯净：纯 Markdown 文档，无任何可执行代码

局限性与风险

• 执行延迟：依赖 Gateway Heartbeat（10-60秒），实际执行可能有~30秒方差
• 配置复杂度：需理解 agentTurn vs systemEvent、isolated vs main 会话等抽象概念
• 清理残留：deleteAfterRun: false 的任务需手动 Janitor 清理
• 严格提示依赖：若未使用 "DELIVER THIS EXACT MESSAGE..." 模式，AI 可能添加冗余评论

适合人群

• 需要精确提醒的 OpenClaw 用户（医疗提醒、会议通知）
• 维护周期性任务的服务管理员（日志轮转、健康检查）
• 跨时区协作需锁定本地时间的团队

常规风险

• 时间误设：ISO 8601 格式错误或未确认时区导致任务提前/延后执行
• 通知静默：误用 systemEvent 导致用户未收到手机推送
• 僵尸任务：旧版本创建的未清理任务堆积，需手动 Janitor 扫描