Cron Mastery

精确调度,告别漂移提醒

system-automation榜 #1

OpenClaw定时任务权威指南,精确区分Cron与Heartbeat适用场景,解决"错过提醒"痛点,2026.2.15+版本标准实践

收藏
63.5k
安装
16.1k
版本
1.0.3
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心定位

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 内容

暂无文件树

手动下载zip · 4.2 kB
contentapplication/octet-stream
请选择文件