定时任务 (Cron)

自动化重复性工作

定时任务 (Cron) 概述

OpenClaw 的 Cron 系统允许您设置定时任务,自动化重复性工作。

通过 Cron 任务,您可以安排定期的数据同步、报告生成、系统维护等操作。

Cron 表达式语法

Cron 表达式由五个字段组成,分别代表分钟、小时、日期、月份和星期几:

* * * * * - 每分钟执行
0 * * * * - 每小时执行
0 9 * * * - 每天上午9点执行
0 9 * * 1 - 每周一上午9点执行
0 */6 * * * - 每6小时执行一次

配置定时任务

config/cron.json 中定义您的定时任务:

{
  "scheduledTasks": [
    {
      "name": "dailyHealthCheck",
      "schedule": "0 8 * * *",
      "action": "run_health_check",
      "enabled": true,
      "notification": {
        "channel": "telegram",
        "recipients": ["admin_user_id"]
      }
    },
    {
      "name": "weeklyReport",
      "schedule": "0 9 * * 1",
      "action": "generate_weekly_report",
      "enabled": true,
      "params": {
        "reportType": "usage_statistics",
        "recipients": ["manager@example.com"]
      }
    },
    {
      "name": "cleanupOldFiles",
      "schedule": "0 2 * * 0",
      "action": "clean_old_files",
      "enabled": true,
      "params": {
        "ageThresholdDays": 30
      }
    }
  ]
}

内置任务类型

系统维护任务

日志清理、临时文件删除、缓存刷新等。

数据同步任务

定期同步外部数据源、备份数据、更新模型等。

监控任务

系统健康检查、服务可用性监控、性能报告生成等。

用户互动任务

定期提醒、报告推送、生日祝福等个性化消息。