⏰ OpenClaw 定时任务完全指南

🕐 什么是 OpenClaw Cron？

OpenClaw 内置了完整的定时任务调度系统（基于 cron 表达式），支持：

• 一次性任务：在指定时间执行一次（如 30 分钟后提醒我）
• 周期性任务：按固定间隔重复执行（如每 2 小时检查一次）
• Cron 表达式：灵活的 cron 语法（如每天早上 8 点）

📋 任务类型详解

1. systemEvent - 系统事件

向主 Agent 注入一条系统消息，触发 Agent 响应：

{
  "name": "早安日报提醒",
  "schedule": {
    "kind": "cron",
    "expr": "0 8 * * *",
    "tz": "Asia/Shanghai"
  },
  "payload": {
    "kind": "systemEvent",
    "text": "提醒：现在是早上8点，请生成今天的 AI 新闻日报。"
  },
  "sessionTarget": "main"
}

2. agentTurn - Agent 执行

在独立会话中让 Agent 执行一个完整的任务：

{
  "name": "SEO巡检",
  "schedule": {
    "kind": "cron",
    "expr": "0 2 * * *",
    "tz": "Asia/Shanghai"
  },
  "payload": {
    "kind": "agentTurn",
    "message": "执行SEO巡检：检查死链、meta标签、sitemap状态，生成报告。",
    "timeoutSeconds": 300
  },
  "sessionTarget": "isolated"
}

⏰ 常用 Cron 表达式

🧪 实战案例

{
  "name": "每日AI新闻日报",
  "schedule": {"kind": "cron", "expr": "0 8 * * *", "tz": "Asia/Shanghai"},
  "payload": {
    "kind": "agentTurn",
    "message": "生成今天的AI新闻日报：搜索最新AI热点，生成HTML页面保存到 /var/www/miaoquai/news/，更新sitemap。",
    "timeoutSeconds": 600
  },
  "sessionTarget": "isolated",
  "delivery": {"mode": "announce"}
}

// 用户说："30分钟后提醒我开会"
{
  "name": "开会提醒",
  "schedule": {"kind": "at", "at": "2026-06-14T09:30:00+08:00"},
  "payload": {
    "kind": "systemEvent",
    "text": "⏰ 提醒：你30分钟前设置了开会提醒，现在该去开会了！"
  },
  "sessionTarget": "main"
}

{
  "name": "网站健康检查",
  "schedule": {"kind": "every", "everyMs": 3600000},
  "payload": {
    "kind": "agentTurn",
    "message": "检查 miaoquai.com 的 HTTP 状态，如果首页返回非200则告警。",
    "timeoutSeconds": 60
  },
  "sessionTarget": "isolated"
}

📊 任务管理

查看所有任务

// 在对话中输入
"列出所有定时任务"
// 或使用 cron 工具
{"action": "list"}

手动触发任务

// 立即执行某个任务
{"action": "run", "jobId": "job-xxx"}

暂停/恢复任务

// 暂停
{"action": "update", "jobId": "job-xxx", "patch": {"enabled": false}}

// 恢复
{"action": "update", "jobId": "job-xxx", "patch": {"enabled": true}}

⚠️ 注意事项