⏰ OpenClaw Cron 定时任务完全指南 2026

🔄 自动化是 Agent 运营的核心。通过 Cron 定时任务，你的 OpenClaw Agent 可以 24/7 自动执行内容生成、数据同步、监控报告等任务。本文教你如何配置和管理 Cron 任务。

Cron 任务类型

1. 系统事件 (systemEvent)

向主会话注入系统消息，触发 Agent 响应。

# 系统事件示例
{
    "kind": "systemEvent",
    "text": "请执行每日 SEO 巡检"
}

2. Agent 轮次 (agentTurn)

在独立会话中执行 Agent 任务。

# Agent 轮次示例
{
    "kind": "agentTurn",
    "message": "生成今日 AI 新闻日报",
    "timeoutSeconds": 300
}

调度类型

1. 一次性任务 (at)

# 在指定时间执行一次
{
    "kind": "at",
    "at": "2026-06-22T10:00:00+08:00"
}

2. 循环任务 (every)

# 每 2 小时执行一次
{
    "kind": "every",
    "everyMs": 7200000
}

3. Cron 表达式 (cron)

# 每天早上 8 点执行
{
    "kind": "cron",
    "expr": "0 8 * * *",
    "tz": "Asia/Shanghai"
}

# 每周一到周五上午 9 点
{
    "kind": "cron",
    "expr": "0 9 * * 1-5",
    "tz": "Asia/Shanghai"
}

创建 Cron 任务

# 创建每日新闻日报任务
cron(
    action="add",
    job={
        "name": "每日AI新闻日报",
        "schedule": {
            "kind": "cron",
            "expr": "0 8 * * *",
            "tz": "Asia/Shanghai"
        },
        "payload": {
            "kind": "agentTurn",
            "message": "执行每日 AI 新闻日报生成任务：1) 搜索今日 AI 热点 2) 生成日报 HTML 3) 更新 sitemap 4) 发送飞书通知",
            "timeoutSeconds": 600
        },
        "sessionTarget": "isolated",
        "delivery": {
            "mode": "announce"
        }
    }
)

妙趣AI 运营时间表

时间 任务 说明
01:00 大规模 SEO 生成 5-10 个工具详情页
02:00 SEO 巡检 检查死链、meta、sitemap
03:00 竞品监控 分析竞品动态
08:00 AI 新闻日报 生成日报网页
12:00 热点追踪 搜索 AI 行业热点
18:00 热点追踪 第 2 次
22:00 每日报告 汇总当日数据

管理 Cron 任务

列出所有任务

cron(action="list")

查看任务详情

cron(action="get", jobId="job_id_here")

立即执行任务

cron(action="run", jobId="job_id_here")

暂停/恢复任务

# 暂停任务
cron(action="update", jobId="job_id_here", patch={"enabled": false})

# 恢复任务
cron(action="update", jobId="job_id_here", patch={"enabled": true})

删除任务

cron(action="remove", jobId="job_id_here")

最佳实践

💡 调度技巧：
  • 避免任务时间冲突，错开高峰期
  • 设置合理的超时时间
  • 使用 delivery 通知任务结果
  • 定期检查任务执行日志
  • 重要任务设置失败告警

任务依赖管理

# 任务 A 完成后触发任务 B
# 方案 1：在任务 A 中调用 cron(action="run", jobId="B")
# 方案 2：设置任务 B 的时间在任务 A 之后
⚠️ 注意：避免创建过于频繁的任务（如每分钟），这可能导致 API 限流。

故障排查

任务未执行

任务执行失败

📖 相关推荐