定时任务管理

技能简介

Cron Mastery 是 OpenClaw 2026.2.15+ 版本的定时任务管理技能，解决”错过提醒”问题，明确区分心跳检查与硬定时任务的适用场景。

业务背景

解决传统定时任务"漏提醒"痛点，帮助业务人员根据场景选对技术方案——手机推送提醒用Cron、后台健康检查用心跳机制。内置时区管理确保跨国团队提醒时间精准无误，避免跨时区协作中的时间误解。

落地案例：某项目经理为埃及开罗的客户设置每周五下午2点项目周报提醒。他在MEMORY.md配置Timezone: Cairo (GMT+2)，创建Cron任务并指定telegram推送。到期时客户准时收到手机通知；同时他为主机配置sessionTarget: "main"的磁盘清理任务，确保系统维护操作拥有完整执行权限。

能做什么

• 设置可靠的定时提醒（支持手机推送）
• 配置周期性系统维护任务
• 理解 Cron 与 Heartbeat 的行为差异与选型
• 管理时区锁定与跨时区提醒
• 实现异步等待与自唤醒机制

使用说明

安装指令：该技能为 OpenClaw 内置能力，无需额外安装。确保系统版本 ≥ 2026.2.15。

基础配置：在 MEMORY.md 中添加用户时区，例如 Timezone: Cairo (GMT+2)。

创建一次性提醒（推送通知）：

{"name": "Remind: Water","schedule": {"kind": "at", "at": "2026-02-06T01:30:00Z"},"payload": {"kind": "agentTurn","message": "DELIVER THIS EXACT MESSAGE TO THE USER WITHOUT MODIFICATION OR COMMENTARY:\n\n💧 Drink water, Momo!"},"sessionTarget": "isolated","delivery": {"mode": "announce", "channel": "telegram", "to": "1027899060"}}

创建后台日志（静默）：

{"name": "Log: System Pulse","schedule": {"kind": "every", "everyMs": 3600000},"payload": {"kind": "systemEvent","text": "[PULSE] System healthy."},"sessionTarget": "main"}

关键规则：

1. 超过1分钟的等待必须使用 Cron，禁止用 act:wait 或内部循环
2. 推送通知必须用 agentTurn + wakeMode: "now"
3. 系统维护任务须指定 sessionTarget: "main" 以确保完整工具权限
4. 一次性任务建议设置 deleteAfterRun: true自动清理

输入与输出

见下方输入与输出表格。

风险提示

• Cron 执行存在网关心跳延迟（约10-60秒），实际触发时间可能有~30秒偏差
• systemEvent 类型不会触发手机推送，仅写入聊天记录
• 子代理（isolated）无法调用 gateway 或删除其他 cron 任务
• 未设置时区将导致提醒时间计算错误
• 遗留的 atMs 格式需迁移为 ISO 8601 字符串格式

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/i-mw/cron-mastery/SKILL.md
来源类型：GitHub 仓库文档