核心用法
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 本身无权限控制,需确保调用环境可信