6.1 定时任务（Cron）：让 AI 自动执行工作

概述

一、定时任务是什么

定时任务 = 让 AI 在指定时间自动做事，不需要你每次手动触发。

典型场景：

• 每天早上 9 点自动推送日报
• 每周一早上 9 点提醒开会
• 每月 1 号自动汇总上月数据
• 客户生日时自动发送祝福

二、Cron 表达式基础

Cron 是表示时间规则的表达式，基本格式：

┌───────────── 分钟 (0-59)
│ ┌───────────── 小时 (0-23)
│ │ ┌───────────── 日期 (1-31)
│ │ │ ┌───────────── 月份 (1-12)
│ │ │ │ ┌───────────── 星期 (0-7, 0和7是周日)
│ │ │ │ │
    *

常用示例

三、配置定时任务

3.1 命令行方式

# 创建定时任务
openclaw cron add --name "早间日报" --every "0 9   *" "推送今日早报"
# 查看所有任务
openclaw cron list
# 删除任务
openclaw cron remove <任务ID>

3.2 配置文件方式

{
  "cron": {
    "jobs": [
      {
        "name": "早间日报",
        "schedule": "0 9   *",
        "action": "sendMessage",
        "target": "飞书群",
        "message": "各位早上好！今日早报已更新，请查收。"
      },
      {
        "name": "晚报",
        "schedule": "0 18   *",
        "action": "sendMessage",
        "target": "飞书群",
        "message": "各位，今天的工作日报已汇总，请查收。"
      }
    ]
  }
}

四、实际案例

案例 1：每日早报推送

{
  "name": "每日早报",
  "schedule": "0 9   *",
  "action": "agent",
  "agent": "main",
  "prompt": "请生成今日早报，包括：
1. 昨日销售数据汇总
2. 今日目标
3. 今日工作重点
4. 行业资讯（1-2条）
发送至：营销中心部门群"
}

案例 2：会议提醒

{
  "name": "会议提醒",
  "schedule": "0 9   1",
  "action": "agent",
  "prompt": "发送会议提醒：
会议时间：今天上午10点
会议主题：周数据复盘
参会人：管理团队
会议议程：上周数据复盘、本周计划"
}

案例 3：客户关怀

{
  "name": "客户生日祝福",
  "schedule": "0 10   *",
  "action": "query",
  "query": "查找今天生日的客户",
  "onResult": "sendBirthdayMessage"
}

五、定时任务类型

六、管理定时任务

查看任务列表

openclaw cron list

手动触发任务

openclaw cron run <任务ID>

查看任务执行历史

openclaw cron runs <任务ID>

禁用/启用任务

# 禁用
openclaw cron disable <任务ID>
# 启用
openclaw cron enable <任务ID>

七、注意事项

八、常见问题

Q：定时任务没执行？ 检查： 1. Gateway 是否在运行 2. 时间表达式是否正确 3. 任务是否被禁用

Q：任务执行了但没效果？ 检查： 1. 目标地址是否正确 2. 执行日志是否有错误 3. AI Agent 是否正常

九、下一步学什么

• 6.2 记忆系统（Memory） → 让 AI 记住重要的事
• 6.3 多 Agent 路由 → 不同人、不同 AI 分别服务

定时任务是 AI 自动化的基础，让 AI 在正确的时间做正确的事！

常见问题