📖 纸质书《OpenClaw超级个体实操手册》已上市! 清华大学出版社出版,在开源教程基础上全面重写+逐条验证。🛒 京东专属购买链接(¥42,原价¥59.8)

第13章节 高级自动化工作流(Cron / Tasks / Task Flow / Hooks / Standing Orders)

本章目标:建立一套符合 OpenClaw 当前官方设计的自动化观念,不再混淆 cron、heartbeat、tasks、Task Flow、hooks 和 standing orders 的职责边界。


版本基线


先给小白的阅读说明

这章最重要的不是命令,而是顺序

很多人一上来就学 Task Flow,最后反而越学越乱。更适合小白的顺序是:

  1. 先学 cron
  2. 再学怎么看 tasks
  3. 最后再上 Task Flowhooksstanding orders

如果你只想先做一个能用的自动化

请先完成这一条最小路径:

如果这 3 步你都能完成,再往后看多步骤编排。

这章适合谁


13.1 先把 6 个概念分清楚

机制 适合什么 什么时候用
cron 精确时间触发 每天、每周、一次性提醒、定时报表
heartbeat 近似定期检查 需要持续“巡检主会话”而不是严格时刻
tasks 记录后台工作 看 detached work 跑了什么、卡在哪
Task Flow 多步骤可恢复编排 A→B→C 这类 durable 流程
hooks 外部轻量触发 外部系统来一个事件,叫醒主会话或跑 isolated job
standing orders 长期授权规则 把“你拥有哪些固定职责”写进 AGENTS.md

官方文档的核心观点非常一致:


13.2 cron:时间驱动自动化的第一选择

13.2.1 一次性提醒

这是最适合新手先练手的例子,因为它结构最简单:到了某个时间点,发一次提醒,然后结束。

openclaw cron add   --name "Reminder"   --at "2026-05-01T16:00:00Z"   --session main   --system-event "Reminder: review the launch checklist"   --wake now   --delete-after-run

13.2.2 每日定时报表

openclaw cron add   --name "Morning brief"   --cron "0 7 * * *"   --tz "Asia/Shanghai"   --session isolated   --message "Summarize overnight updates, key tasks, and calendar priorities."   --announce

13.2.3 运维常用命令

看到什么算 cron 已经跑通

你至少要会检查这 3 件事:

openclaw cron list
openclaw cron runs --id <job-id>
openclaw cron run <job-id>
openclaw cron edit <job-id> --message "Updated prompt"
openclaw cron remove <job-id>

13.2.4 现在应该怎么选 session 模式


13.3 tasks:先学会看账本,再谈复杂编排

很多人把自动化做复杂了,最后却不知道“到底什么在跑、哪里失败了”。这就是 tasks 的意义。

13.3.1 你最该会的命令

openclaw tasks list
openclaw tasks show <task-id>
openclaw tasks cancel <task-id>
openclaw tasks audit

13.3.2 tasks audit 最有价值的地方

它会直接告诉你是否存在:

如果你已经在用:

tasks audit 应该成为你的固定巡检动作。


13.4 Task Flow:多步骤流程的标准编排层

Task Flow 适合:

13.4.1 两种模式

Managed mode:Task Flow 自己驱动每一步任务

适合:

Mirrored mode:Task Flow 只观察外部任务并同步状态

适合:

13.4.2 CLI 命令

openclaw tasks flow list
openclaw tasks flow show <lookup>
openclaw tasks flow cancel <lookup>

13.4.3 什么时候不要上 Task Flow

以下情况先别急着上:

这时先用 cron 或 isolated job 更稳。


13.5 hookswebhooks plugin:把外部系统接进来

13.5.1 轻量触发:hooks

官方 hooks 适合外部事件进来后:

配置:

{
  "hooks": {
    "enabled": true,
    "token": "replace-with-dedicated-hook-token",
    "path": "/hooks"
  }
}

调用 wake

curl -X POST http://127.0.0.1:18789/hooks/wake   -H 'Authorization: Bearer SECRET'   -H 'Content-Type: application/json'   -d '{"text":"New invoice received","mode":"now"}'

调用 agent

curl -X POST http://127.0.0.1:18789/hooks/agent   -H 'Authorization: Bearer SECRET'   -H 'Content-Type: application/json'   -d '{"message":"Summarize the new invoice and extract payable date","name":"Finance","model":"openai/gpt-5.4-mini"}'

13.5.2 多步骤编排:webhooks plugin

如果你是 Zapier、n8n、CI、表单系统来驱动复杂流程,直接用 webhooks plugin 绑定 Task Flow。官方配置形态:

{
  "plugins": {
    "entries": {
      "webhooks": {
        "enabled": true,
        "config": {
          "routes": {
            "ops": {
              "path": "/plugins/webhooks/ops",
              "sessionKey": "agent:main:main",
              "secret": {
                "source": "env",
                "provider": "default",
                "id": "OPENCLAW_WEBHOOK_SECRET"
              },
              "controllerId": "webhooks/ops",
              "description": "Ops TaskFlow bridge"
            }
          }
        }
      }
    }
  }
}

最常用两个动作

这比旧教程里一堆 shell glue code 更稳定,也更方便排障。


13.6 standing orders:自动化不是“计划”,而是“长期授权”

OpenClaw 官方现在把 standing orders 讲得很清楚:它们不是某个定时器,而是写在 agent workspace 里的长期授权规则。推荐直接放在 AGENTS.md 里,因为这个文件会自动注入到每次会话。

13.6.1 一个合格的 standing order 长什么样

## Program: Weekly Status Report

**Authority:** Compile data, generate report, deliver to stakeholders
**Trigger:** Every Friday at 4 PM (enforced via cron job)
**Approval gate:** None for standard reports. Flag anomalies for human review.
**Escalation:** If data source is unavailable or metrics look unusual

### Execution Steps

1. Pull metrics from configured sources
2. Compare to prior week and targets
3. Generate report in Reports/weekly/YYYY-MM-DD.md
4. Deliver summary via configured channel
5. Log completion to Agent/Logs/

### What NOT to Do

- Do not send reports to external parties
- Do not modify source data
- Do not skip delivery if metrics look bad

13.6.2 为什么它重要

没有 standing orders:

有 standing orders:


13.7 推荐的自动化组合,不推荐的自动化组合

推荐组合

组合 1:定时报表

组合 2:外部系统驱动的多步流程

组合 3:长期研究 / 知识运营

不推荐组合


13.8 本章实践建议

如果你要从 0 到 1 搭一套稳定自动化,顺序应该是:

  1. 先用 cron 跑通一个固定任务
  2. 再学会看 tasks listtasks audit
  3. 多步骤时再上 Task Flow
  4. 外部系统接入时再开 hooks / webhooks plugin
  5. 最后把长期职责沉淀进 AGENTS.md

13.9 官方参考