cron-mastery

精准定时任务调度指南

OpenClaw官方定时任务指南,精准解决提醒漂移问题,确保关键任务准时触达。

收藏
2.5k
安装
961
版本
v2026.2.15
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Cron Mastery 是 OpenClaw 生态中专用于时间管理的技能文档,核心解决「心跳漂移」导致的提醒失效问题。它严格区分两种计时机制:Heartbeat(宽松轮询,适合邮件检查、新闻摘要等低优先级任务)和 Cron(精确调度,适合提醒、日报、系统维护)。

使用上遵循三大模式:一是设置可靠提醒,通过 cron:add 配合 at 一次性调度,替代 act:wait 长等待;二是部署每日清理器(Janitor),自动删除已完成的幽灵任务;三是跨回合等待时必须用 Cron 自唤醒,避免会话休眠导致任务丢失。

显著优点

1. 精准性保障:强制事件注入机制确保 atMs 时间点必定触发,不受心跳周期影响
2. 防踩坑设计:明确标注 "deliver": true 关键参数,避免「黑屋执行」——任务运行但用户无感知

3. 运维闭环:提供完整的 Janitor 清理方案,解决一次性任务残留问题

4. 场景化决策表:用对比表格清晰指导何时选 Heartbeat、何时选 Cron

潜在缺点与局限性

  • 系统时钟依赖:若主机时间漂移,Cron 触发点会同步偏移
  • 无持久化状态:任务仅存在于内存/临时存储,服务重启可能丢失未触发任务
  • 时区管理负担:必须手动维护用户时区信息,否则跨时区提醒会出错
  • 毫秒级不适用:文档明确不建议用于关键精密计时场景

适合的目标群体

  • OpenClaw/Claude 生态的开发者与高级用户
  • 需要构建可靠提醒系统的个人助理场景
  • 运维自动化需求(定期报告、清理任务)
  • 对「为什么我的提醒没响」感到困惑的调试者

使用风险

  • 配置误用风险:JSON 模板参数错误(如遗漏 deliver)导致静默失败
  • 任务堆积风险:未启用 Janitor 时,长期运行会产生大量禁用态幽灵任务
  • 时区混淆风险:用户说「9点」未确认时区时,实际触发时间可能偏差数小时
  • 权限分离风险:实际 Cron 操作依赖系统工具层,Skill 本身无权限控制,需确保调用环境可信

cron-mastery 内容

references文件夹
手动下载zip · 3.3 kB
TEMPLATES.mdtext/markdown
请选择文件