什么是 Task Flow
Task Flow 是 OpenClaw v2026.3.31 引入、v2026.4.2 增强的流程编排层，位于后台任务系统之上。它管理多步骤工作流，提供持久化状态追踪、版本修订和 CLI 检查能力。
与单次 Cron 任务或后台命令不同，Task Flow 适合需要多步骤协调、状态持久化、失败恢复的复杂场景。
后台任务系统架构
OpenClaw 的自动化体系包含五个层级：
| 层级 | 用途 | 触发方式 |
|---|---|---|
| Standing Orders | 永久操作授权 | 每次会话自动注入 |
| Task Flow | 多步骤工作流编排 | 程序化触发 |
| Background Tasks | 后台任务账本 | ACP、子代理、Cron、CLI |
| Cron | 定时任务 | 时间表达式 |
| Hooks | 事件驱动脚本 | 生命周期事件 |
Task Flow 统一管理 ACP 运行、子代理生成、Cron 隔离执行和 CLI 操作，由 SQLite 后端的任务账本追踪。
managed 与 mirrored 模式
Task Flow 区分两种同步模式：
managed 模式
平台托管的任务，由 OpenClaw 网关直接管理生命周期：
# 网关创建并管理的任务
# 状态完全由网关控制
# 适合：Cron 任务、ACP 运行、内部工作流
mirrored 模式
本地镜像的任务，状态从外部源同步：
# 状态从外部系统镜像
# 网关只读追踪，不控制生命周期
# 适合：外部 CI/CD 流水线、第三方任务系统
持久化状态追踪
v2026.4.2 引入了持久化流状态追踪：
- 任务状态写入 SQLite 持久存储
- 网关重启后可恢复进行中的任务
- 每个流程维护修订版本号
- 支持丢失任务自动恢复
CLI 管理命令
查看任务列表
# 列出所有后台任务
openclaw tasks list
# 查看任务审计日志
openclaw tasks audit
流程管理
# 列出所有工作流
openclaw tasks flow list
# 查看特定工作流详情
openclaw tasks flow show <flow-id>
# 取消运行中的工作流
openclaw tasks flow cancel <flow-id>
聊天内查看
在任何聊天频道中输入 /tasks 即可查看当前会话的后台任务状态，无需切换到命令行。
与 Cron 的协作
Task Flow 与 Cron 定时系统协作使用：
# config.yaml 示例
automation:
cron:
- name: "每日报告"
schedule: "0 9 * * *"
tools:
- web_search
- web_fetch
- message
prompt: "搜索今日 AI 行业新闻，生成摘要报告发送到工作群"
Cron 任务执行时会自动注册到 Task Flow 账本，可通过 openclaw tasks list 统一查看。
工具白名单
每个 Cron 任务可单独设置工具白名单：
# 为定时任务指定可用工具
openclaw cron --tools web_search,web_fetch,message
这确保定时任务只能使用指定的工具，防止意外的工具调用。
维护与清理
Task Flow 系统自动进行维护扫描：
- 自动清理：已完成的任务在保留期后自动清理
- 丢失恢复：检测并恢复因网关意外重启而中断的任务
- 审计日志：所有任务执行记录保留供审计
# 查看维护状态
openclaw tasks audit
# 手动触发维护扫描
openclaw tasks maintain
实际应用场景
自动化内容发布流水线
- Cron 定时触发内容生成
- Task Flow 编排：搜索素材 → 生成内容 → 审批 → 发布
- 每一步状态持久化，失败可从断点恢复
多渠道消息同步
- 收到微信群消息触发工作流
- AI 处理并生成回复
- 同步发送到飞书、钉钉等多个渠道
- Task Flow 追踪每个渠道的发送状态
注意事项
- Task Flow 需要 v2026.3.31 或更高版本
- SQLite 后端在高并发场景下可能需要调优
- 维护扫描不应阻塞网关事件循环（v2026.4.1 已修复此问题）
- 建议定期检查
openclaw tasks audit确认任务健康状态