OpenClaw 定时任务 (Cron) 设置教程

💻 实战示例

示例 1: 每日新闻摘要

// 每天早上8点自动生成AI新闻简报
cron({
  action: "add",
  job: {
    name: "daily-ai-news",
    description: "每日AI新闻简报",
    schedule: {
      kind: "cron",
      expr: "0 8 * * *",
      tz: "Asia/Shanghai"
    },
    payload: {
      kind: "agentTurn",
      message: `搜索今天AI行业的重大新闻，整理成摘要报告：
      - 按类别分类（技术突破/产品发布/融资动态）
      - 每个新闻配一句话摘要
      - 附上原文链接
      保存到 /var/www/miaoquai/news/ 目录`,
      timeoutSeconds: 300
    },
    delivery: {
      mode: "announce",
      channel: "feishu"
    }
  }
});

示例 2: 定时提醒

// 30分钟后提醒喝水
cron({
  action: "add",
  job: {
    name: "drink-water-reminder",
    schedule: {
      kind: "at",
      at: "2026-04-12T10:30:00+08:00"
    },
    payload: {
      kind: "systemEvent",
      text: "⏰ 提醒：该喝水了！工作再忙也要照顾好身体~"
    },
    deleteAfterRun: true  // 执行后自动删除
  }
});

示例 3: 周期性 SEO 任务

// 每天凌晨1点批量生成SEO内容
cron({
  action: "add",
  job: {
    name: "daily-seo-generation",
    description: "每日SEO内容批量生成",
    schedule: {
      kind: "cron",
      expr: "0 1 * * *",
      tz: "Asia/Shanghai"
    },
    payload: {
      kind: "agentTurn",
      message: `执行每日SEO任务：
      1. 分析搜索热词
      2. 批量生成5-8个教程页面
      3. 更新 sitemap.xml
      4. 生成执行报告`,
      timeoutSeconds: 3600
    }
  }
});

示例 4: 每周报告

// 每周五下午6点生成周报
cron({
  action: "add",
  job: {
    name: "weekly-report",
    schedule: {
      kind: "cron",
      expr: "0 18 * * 5",
      tz: "Asia/Shanghai"
    },
    payload: {
      kind: "agentTurn",
      message: `生成本周工作周报：
      1. 查询本周执行的所有定时任务
      2. 统计生成的内容数量
      3. 汇总数据指标
      4. 生成markdown格式报告
      发送到飞书群`,
      timeoutSeconds: 600
    },
    delivery: {
      mode: "announce",
      channel: "weekly-reports"
    }
  }
});

示例 5: 简单的 QQ 定时提醒

// 使用 qqbot_remind 简化接口
qqbot_remind({
  action: "add",
  content: "喝水时间到！",
  time: "30m"  // 30分钟后
});

// 每天早8点提醒
qqbot_remind({
  action: "add",
  content: "早安！开始新的一天~",
  time: "0 8 * * *",  // cron 表达式
  timezone: "Asia/Shanghai"
});