OpenClaw 定时任务（Cron）配置与使用

什么是 OpenClaw Cron？

OpenClaw 内置了定时任务调度器，可以让 AI 助手按固定时间间隔自动执行任务。例如：

每天早上推送新闻摘要
每小时检查服务器状态
每周生成工作周报

启用 Cron

在 openclaw.json 中配置：

{
  cron: {
    enabled: true,
    store: "~/.openclaw/cron/cron.json",
    maxConcurrentRuns: 2,
    sessionRetention: "24h",
    runLog: {
      maxBytes: "2mb",
      keepLines: 2000
    }
  }
}

参数说明

enabled：是否启用定时任务调度器
store：任务定义的持久化存储路径
maxConcurrentRuns：最大同时运行的任务数，防止资源过载
sessionRetention：任务执行记录的保留时长
runLog.maxBytes：运行日志的最大大小
runLog.keepLines：日志保留的最大行数

创建定时任务

通过聊天命令创建：

/cron add "每天早上9点推送今日新闻摘要" --schedule "0 9 * * *"

或在配置文件中定义。

Heartbeat：内置心跳任务

OpenClaw 还提供了专用的心跳机制，用于定期检查 AI 助手的运行状态：

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",                          // 每 30 分钟执行一次
        model: "anthropic/claude-sonnet-4-6",  // 使用的模型
        target: "last",                        // 发送目标
        directPolicy: "allow",
        to: "+15555550123",                    // 接收通知的联系人
        prompt: "HEARTBEAT",                   // 心跳提示词
        ackMaxChars: 300                       // 回复最大字数
      }
    }
  }
}

心跳任务会定期唤醒 AI 助手，可以用来做主动提醒、状态报告等周期性工作。

注意事项

Cron 任务在网关运行期间有效，网关关闭后任务暂停
maxConcurrentRuns 建议设为 1-3，避免同时运行过多任务消耗模型额度
任务执行记录存储在 store 路径，定期检查磁盘占用