> 📖 **纸质书《OpenClaw超级个体实操手册》已上市！** 清华大学出版社出版，在开源教程基础上全面重写+逐条验证。🛒 [京东专属购买链接（¥42，原价¥59.8）](https://item.jd.com/14669463.html) # 第13章节 高级自动化工作流（Cron / Tasks / Task Flow / Hooks / Standing Orders） > 本章目标：建立一套符合 OpenClaw 当前官方设计的自动化观念，不再混淆 cron、heartbeat、tasks、Task Flow、hooks 和 standing orders 的职责边界。 --- ## 版本基线 - **当前稳定版**：`v2026.9.3`（2026-09-08 发布） - 自动化章节默认按 `v2026.9.3` 稳定版行为说明；升级后先 `openclaw doctor --fix` --- ## 先给小白的阅读说明 ### 这章最重要的不是命令，而是顺序 很多人一上来就学 `Task Flow`，最后反而越学越乱。更适合小白的顺序是： 1. 先学 `cron` 2. 再学怎么看 `tasks` 3. 最后再上 `Task Flow`、`hooks`、`standing orders` ### 如果你只想先做一个能用的自动化 请先完成这一条最小路径： - 用 `cron` 建一个每天早上跑的任务 - 用 `tasks list` 看它有没有进入后台账本 - 用 `tasks show` 看一次任务详情 如果这 3 步你都能完成，再往后看多步骤编排。 ### 这章适合谁 - 已经能稳定使用 OpenClaw，但想把重复工作交给它 - 想把“提醒、报表、扫描、汇总”变成固定流程 - 想接外部触发，但还分不清 `hooks` 和 `webhooks` --- ## 13.1 先把 6 个概念分清楚 | 机制 | 适合什么 | 什么时候用 | |------|----------|------------| | `cron` | 精确时间触发 | 每天、每周、一次性提醒、定时报表 | | `heartbeat` | 近似定期检查 | 需要持续“巡检主会话”而不是严格时刻 | | `tasks` | 记录后台工作 | 看 detached work 跑了什么、卡在哪 | | `Task Flow` | 多步骤可恢复编排 | A→B→C 这类 durable 流程 | | `hooks` | 外部轻量触发 | 外部系统来一个事件，叫醒主会话或跑 isolated job | | `standing orders` | 长期授权规则 | 把“你拥有哪些固定职责”写进 `AGENTS.md` | 官方文档的核心观点非常一致： - `cron` 是调度器 - `tasks` 是后台工作账本 - `Task Flow` 是位于 tasks 之上的耐久编排层 - `standing orders` 是 agent 的长期运营授权，不是调度器本身 --- ## 13.2 `cron`：时间驱动自动化的第一选择 ### 13.2.1 一次性提醒 这是最适合新手先练手的例子，因为它结构最简单：到了某个时间点，发一次提醒，然后结束。 ```bash 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 每日定时报表 ```bash 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 ` 能看到实际运行记录 - 如果任务是长时间运行的，`tasks list` 里也能看到对应后台任务 ```bash openclaw cron list openclaw cron runs --id openclaw cron run openclaw cron edit --message "Updated prompt" openclaw cron remove ``` ### 13.2.4 现在应该怎么选 session 模式 - `main`：适合提醒、系统事件、继续主会话上下文 - `isolated`：适合日报、扫描、报告、批处理 - `current`：适合绑定当前会话的重复任务 - `session:custom-id`：适合每天都延续同一份上下文的固定流程 --- ## 13.3 `tasks`：先学会看账本，再谈复杂编排 很多人把自动化做复杂了，最后却不知道“到底什么在跑、哪里失败了”。这就是 `tasks` 的意义。 ### 13.3.1 你最该会的命令 ```bash openclaw tasks list openclaw tasks show openclaw tasks cancel openclaw tasks audit ``` ### 13.3.2 `tasks audit` 最有价值的地方 它会直接告诉你是否存在： - `stale_queued` - `stale_running` - `lost` - `delivery_failed` - `missing_cleanup` - `inconsistent_timestamps` 如果你已经在用： - 视频生成 - 音乐生成 - isolated cron - subagent / ACP 子任务 那 `tasks audit` 应该成为你的固定巡检动作。 --- ## 13.4 `Task Flow`：多步骤流程的标准编排层 Task Flow 适合： - 多步骤串行或分支流程 - 要求持久化状态 - 需要在 gateway 重启后继续 - 需要统一查看流程进度 ### 13.4.1 两种模式 **Managed mode**：Task Flow 自己驱动每一步任务 适合： - 周报流水线 - 内容生产流水线 - 审批后自动交付 **Mirrored mode**：Task Flow 只观察外部任务并同步状态 适合： - 已经有 cron / CLI / 外部系统在生成任务 - 你只是想把多个任务收敛成一个流程视图 ### 13.4.2 CLI 命令 ```bash openclaw tasks flow list openclaw tasks flow show openclaw tasks flow cancel ``` ### 13.4.3 什么时候不要上 Task Flow 以下情况先别急着上： - 只是单次后台任务 - 只是每天一个固定提醒 - 你还不会看 `tasks list` / `tasks audit` - 工作流步骤还没稳定，今天改一版、明天改一版 这时先用 cron 或 isolated job 更稳。 --- ## 13.5 `hooks` 与 `webhooks` plugin：把外部系统接进来 ### 13.5.1 轻量触发：`hooks` 官方 `hooks` 适合外部事件进来后： - 唤醒主会话 - 触发一次 isolated agent run 配置： ```json { "hooks": { "enabled": true, "token": "replace-with-dedicated-hook-token", "path": "/hooks" } } ``` 调用 `wake`： ```bash 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`： ```bash 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。官方配置形态： ```json { "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" } } } } } } } ``` **最常用两个动作**： - `create_flow` - `run_task` 这比旧教程里一堆 shell glue code 更稳定，也更方便排障。 --- ## 13.6 `standing orders`：自动化不是“计划”，而是“长期授权” OpenClaw 官方现在把 standing orders 讲得很清楚：它们不是某个定时器，而是**写在 agent workspace 里的长期授权规则**。推荐直接放在 `AGENTS.md` 里，因为这个文件会自动注入到每次会话。 ### 13.6.1 一个合格的 standing order 长什么样 ```md ## 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： - 你每次都要重复下达同样的管理指令 - agent 只能“被动等你叫” - routine work 很容易中断 有 standing orders： - 责任边界更清楚 - 人工审批点更清楚 - agent 的长期行为更可控 - cron 只负责“何时跑”，AGENTS.md 负责“跑什么、什么时候停” --- ## 13.7 推荐的自动化组合，不推荐的自动化组合 ### 推荐组合 **组合 1：定时报表** - `cron` - `tasks list / audit` - `AGENTS.md` standing order **组合 2：外部系统驱动的多步流程** - `hooks` 或 `webhooks` plugin - `Task Flow` - `tasks flow show` **组合 3：长期研究 / 知识运营** - `cron` - `infer web search / fetch` - `Memory Wiki` ### 不推荐组合 - 只用 shell while true + sleep 模拟调度 - 用一个超大 prompt 代替 standing orders - 还不会看 `tasks audit` 就上很多 subagent 和 webhook - 把外部系统 token 直接写进仓库 --- ## 13.8 本章实践建议 如果你要从 0 到 1 搭一套稳定自动化，顺序应该是： 1. 先用 `cron` 跑通一个固定任务 2. 再学会看 `tasks list` 和 `tasks audit` 3. 多步骤时再上 `Task Flow` 4. 外部系统接入时再开 `hooks` / `webhooks` plugin 5. 最后把长期职责沉淀进 `AGENTS.md` --- ## 13.9 官方参考 - GitHub Releases：https://github.com/openclaw/openclaw/releases - Automation Overview：https://docs.openclaw.ai/automation/cron-vs-heartbeat - Scheduled Tasks：https://docs.openclaw.ai/automation/cron-jobs - Background Tasks：https://docs.openclaw.ai/automation/tasks - Task Flow：https://docs.openclaw.ai/automation/taskflow - Standing Orders：https://docs.openclaw.ai/automation/standing-orders - Webhooks Plugin：https://docs.openclaw.ai/plugins/webhooks