精准定时任务调度指南

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

基本信息

• 技能名称?cron-mastery
• 中文名称?精准定时任务调度指南
• 作者?i-mw
• 分类?其他
• 版本?未标注
• 标签?automation, productivity, development-engineering, docs, backend

使用方法

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