cron-mastery

核心用法

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 是 OpenClaw 生态中时间管理的规范性文档，而非可执行代码。它系统性地解决了 AI Agent 在时间敏感任务中常见的"提醒漂移"痛点，建立了一套严格的 Cron/Heartbeat 分离原则。

核心用法

1. 精准提醒调度：强制使用 cron:add 配合 at 一次性调度，替代低效的 act:wait 循环
2. 关键投递规则：agentTurn 必须设置 "deliver": true，否则用户不可见
3. 自动清理机制：24小时 Janitor 任务自动删除已完成的"幽灵任务"
4. 时区锁定：强制记录用户时区到 MEMORY.md

显著优点

• 零代码风险：纯 Markdown 文档，无可执行代码，通过 S 级安全认证
• 行为可预测：消除 Heartbeat 的时间漂移（30分钟心跳无法保证"10分钟后提醒"）
• 生产级规范：提供标准 JSON 载荷模板，降低配置错误率
• 自维护设计：Janitor 模式解决 Cron 任务列表膨胀问题

潜在局限

• 生态绑定：深度依赖 OpenClaw 特定接口（cron:add/cron:list/cron:wake），无通用性
• 手动维护：Janitor 需人工部署，非系统自动机制
• 时区脆弱：依赖 MEMORY.md 的人工维护，无自动检测兜底

适合人群

• 需要可靠提醒的 OpenClaw 用户（日程管理、健康提醒）
• 开发周期性维护任务的 Agent 开发者
• 对时间精度有要求（分钟级）的场景

常规风险

• 静默失败：deliver: false 导致提醒"在暗室中执行"，用户完全无感知
• 时区误解：未确认时区导致的日程错乱
• 任务堆积：未运行 Janitor 时，历史任务残留影响可读性

---

安全认证：S级（100分），无外部依赖，无网络调用，GDPR/CCPA 全合规