什么是Cron Mastery
Cron Mastery 是 OpenClaw 2026.2.15+ 版本中用于精确管理时间调度的核心技能，旨在解决传统提醒机制不可靠的问题。该系统通过严格区分心跳（heartbeat）与定时任务（cron），确保关键提醒和定期维护能够准时执行。心跳适用于低频、非关键的检查类操作，如邮件查看或新闻摘要；而 cron 则专用于需要精确时间触发的场景，例如“5分钟后提醒喝水”或每日系统报告。这种分离机制有效避免了因心跳漂移导致的任务遗漏风险。 Cron Mastery 的核心在于其现代化的调度模型：所有一次性提醒必须使用 `cron:add` 配合 `at` 类型的时间戳来创建，并建议设置 `deleteAfterRun: true` 实现自动清理。对于推送通知类任务，推荐采用 AgentTurn + Strict Instructions 模式，以确保消息能主动送达用户设备（如 Telegram 或 WhatsApp），而非仅记录在聊天历史中。此外，系统已修复早期版本中的并发死锁问题，并支持通过 `sessionTarget: “main”` 调用主会话执行系统级维护操作。 值得注意的是，cron 的执行精度依赖于网关的心跳间隔（通常每10-60秒一次），因此实际触发时间可能存在最多约30秒的偏差。为提升可靠性，建议在初始化时明确指定时区信息（如 MEMORY.md 中写入 `Timezone: Cairo (GMT+2)`），并在用户设定模糊时间时主动确认具体时间点。对于跨会话等待需求，若延迟小于1分钟可保持工具循环开启使用 `act:wait`；超过1分钟则必须依赖 cron 任务唤醒，否则代理将进入休眠状态无法自行恢复。
核心功能特点
- 支持高精度一次性提醒与周期性任务调度，基于 ISO 8601 标准时间戳配置
- 内置自动清理机制，单次任务完成后默认删除，减少手动维护负担
- 提供两种消息传递模式：systemEvent 用于静默日志记录，AgentTurn 配合 announce 模式实现主动推送通知
- 修复早期版本的并发冲突问题，优化 cron.add 参数传递效率
- 强制要求指定时区信息以保证跨地域用户的准确理解与执行
适用场景
Cron Mastery 特别适合需要可靠时间触发的日常事务管理场景。例如，家庭成员间的健康提醒（如定时饮水、服药通知）可通过设置 `agentTurn` 类型的 cron 任务，在指定时间向手机发送无修饰的纯文本提示，确保及时响应。企业运维场景中，每日凌晨自动生成的系统健康报告也可利用 cron 精准调度，避免人工干预遗漏。对于开发测试环境，定期清理临时文件或数据库备份同样适用此机制，只需配置合理的执行周期即可持续运行。 在个人生产力提升方面，该工具能有效替代不稳定的本地闹钟应用。无论是会议前5分钟的准备提醒，还是每周项目复盘报告的生成，均可通过标准化的 JSON 结构快速部署。尤其当结合 `sessionTarget: “isolated”` 使用时，还能隔离不同任务的上下文，防止相互干扰。对于长期运行的自动化流程，如监控服务器状态并记录日志，则更适合采用 `systemEvent` 方式，因其不会产生额外交互噪音且资源消耗更低。 复杂业务逻辑集成时，Cron Mastery 亦展现出良好的扩展性。例如电商平台的库存同步、社交媒体内容定时发布等场景，均可通过调整 payload 结构和 delivery 配置适配不同渠道。同时，由于支持 legacy 模式的平滑迁移，旧有 cron 作业无需大规模重构即可逐步升级至新版规范，降低了技术债务积累的风险。