定时任务：让助手到点自己醒

Cron 是网关内置的调度器：任务持久化保存，到点唤醒智能体干活，结果可以发回聊天渠道、推给 Webhook，或者哪儿都不发只默默执行。

心智模型

• 调度器跑在网关进程里，不在模型里——网关不开，任务不响。
• 任务定义、运行状态与历史都持久化在共享 SQLite 状态库里，重启不丢。
• 每次执行会生成一条后台任务记录，可查可审。

三分钟上手

一次性提醒：

openclaw cron create "2027-02-01T16:00:00Z" \
  --name "Reminder" \
  --session main \
  --system-event "Reminder: check the cron docs draft" \
  --wake now \
  --delete-after-run

管好你的任务：

openclaw cron list              # 任务清单
openclaw cron get <job-id>      # 看定义
openclaw cron runs --id <job-id> # 看运行历史

关键行为细节

• 一次性任务自动清理：默认成功后自删，想保留加 --keep-after-run。
• 超时预算分层：设了 --timeout-seconds 用你的；没设的话隔离式智能体任务受 60 分钟看门狗限制，命令任务默认 10 分钟、脚本载荷默认 5 分钟。
• 错过的任务不硬补：网关重启后，逾期任务会被重新调度而不是立即重放，避免刚开机就被引导工作占满。

与记忆的分工

官方在记忆文档里给过一个清晰的边界：精确的未来动作交给定时任务，持久的上下文交给记忆。比如「明天面试后跟进我」不该存成长期事实，而应该是一个一次性 Cron 任务。

典型用法

• 每天早上把收件箱摘要、日历与新闻推到 Telegram。
• 周五下午自动整理本周会话里的待办。
• 每小时巡一次关键词监控，有动静才说话。

Cron 管「到点醒」，Heartbeat 管「没事也巡查」：看主动巡检。