OpenClaw定时任务权威指南,精确区分Cron与Heartbeat适用场景,解决”错过提醒”痛点,2026.2.15+版本标准实践
说明:
## 核心定位
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级风险**:时区未锁定时的跨午夜调度错误,建议强制校验环节纳入交互流程。









