⏰ OpenClaw定时任务完全指南

🎯 什么是OpenClaw定时任务？

OpenClaw的定时任务功能基于cron调度器，让你可以安排Agent在未来某个时间点或按特定周期自动执行消息。这就像是给Agent请了个闹钟服务，到点就干活，绝不偷懒。

常见的使用场景包括：

• 每天早上8点生成数据报告
• 每小时检查一次网站状态
• 每周五下午发送周报汇总
• 每月1号备份重要数据
• 特定日期执行一次性提醒

🛠️ 核心功能详解

1. 定时任务类型

2. 会话目标选项

定时任务可以指定在哪里执行：

• main - 在主会话执行（适合简单提醒）
• isolated - 在隔离会话执行（默认，推荐）
• current - 在当前会话执行
• session:xxx - 在指定命名会话执行

📝 使用方法

创建一次性任务（at）

{
  "name": "会议提醒",
  "schedule": {
    "kind": "at",
    "at": "2026-04-16T15:00:00+08:00"
  },
  "payload": {
    "kind": "agentTurn",
    "message": "提醒：15分钟后有产品评审会议"
  },
  "sessionTarget": "isolated"
}

创建周期任务（every）

{
  "name": "邮件检查",
  "schedule": {
    "kind": "every",
    "everyMs": 7200000
  },
  "payload": {
    "kind": "agentTurn",
    "message": "检查新邮件并总结重要事项"
  }
}

创建复杂周期任务（cron）

{
  "name": "晨间简报",
  "schedule": {
    "kind": "cron",
    "expr": "0 9 * * 1-5",
    "tz": "Asia/Shanghai"
  },
  "payload": {
    "kind": "agentTurn",
    "message": "生成今日待办事项和昨日完成总结"
  }
}

💡 最佳实践

🔧 高级用法示例

完整工作流：每日数据报告

{
  "name": "每日数据报告",
  "description": "每天早上8点抓取网站数据并生成报告",
  "schedule": {
    "kind": "cron",
    "expr": "0 8 * * *",
    "tz": "Asia/Shanghai"
  },
  "payload": {
    "kind": "agentTurn",
    "message": "执行每日数据报告工作流：1）使用web_search搜索昨日AI行业热点；2）使用web_fetch获取OpenClaw官方更新；3）整理成Markdown格式报告；4）发送到飞书群",
    "model": "claude-3-5-sonnet"
  },
  "delivery": {
    "mode": "announce",
    "channel": "general"
  },
  "failureAlert": {
    "mode": "announce",
    "after": 2,
    "cooldownMs": 3600000
  }
}

带webhook回调的任务

{
  "name": "服务器健康检查",
  "schedule": {
    "kind": "every",
    "everyMs": 300000
  },
  "payload": {
    "kind": "agentTurn",
    "message": "检查服务器状态：CPU、内存、磁盘使用率"
  },
  "delivery": {
    "mode": "webhook",
    "to": "https://your-server.com/webhook/health"
  }
}

📚 相关链接