🏭什么是 Task Flow？

Task Flow 是 OpenClaw v2026.4.2 重新引入的任务编排层，位于后台任务（Background Tasks）之上。它管理持久化的多步骤工作流，拥有自己的状态、版本追踪和同步语义。

简单理解：Task Flow = 多个后台任务的总指挥。它能让你创建一个长期运行的工作流，跨越多次 agent 调用甚至多次重启，而每个具体步骤由后台任务执行。

⚙️Task Flow 的两种同步模式

模式	说明	适用场景
Managed（托管模式）	Task Flow 全权管理生命周期，自己创建和驱动任务	自动化流水线、收件箱分类、PR审核流程
Mirrored（镜像模式）	Task Flow 只观察外部创建的任务，保持同步但不自建	对接已有 CI/CD、外部系统监控

🖥️CLI 命令

# 查看所有活跃和最近的任务流
openclaw tasks flow list

# 查看某个任务流的详细信息
openclaw tasks flow show 

# 取消一个正在运行的任务流
openclaw tasks flow cancel <lookup>

📊任务看板 — /tasks 命令

在任何聊天会话中输入 /tasks 即可查看该会话关联的后台任务：

/tasks

任务看板显示：

活跃和最近完成的任务
运行时类型（ACP / Subagent / Cron / CLI）
状态（运行中 / 成功 / 失败 / 超时 / 取消）
时间和进度详情

💡 状态说明

`queued`	已创建，等待 agent 启动
`running`	agent 正在执行
`succeeded`	成功完成
`failed`	执行出错
`timed_out`	超过超时限制
`cancelled`	被操作员取消
`lost`	会话消失（超过5分钟无响应）

🔔任务通知策略

每个任务可以配置不同的通知级别：

策略	行为
`done_only`（默认）	仅在任务结束时通知（成功/失败/超时等）
`state_changes`	每次状态变化都通知
`silent`	完全不通知

# 修改某个任务的 notification 策略
openclaw tasks notify <lookup> state_changes

🔍ClawFlow — Task Flow 的底层实现

ClawFlow 是 Task Flow 的运行时底层。对于需要跨越多个 detached 任务、但仍想保持单一所有者上下文的复杂工作流，ClawFlow 提供：

Flow 身份（flowId）
所有者会话和返回上下文
等待状态 + 小型持久化输出袋
完成 / 失败 / 取消 / 阻塞状态管理

💡 典型工作流

1. createFlow(...)         → 创建 flow
2. runTaskInFlow(...)     → 在 flow 中运行任务
3. setFlowWaiting(...)    → 等待外部事件
4. resumeFlow(...)       → 恢复 flow
5. setFlowOutput(...)    → 设置输出
6. finishFlow(...)       → 完成 flow

🏗️如何用 Task Flow 编排复杂任务？

以「每周报告」为例，一个完整的多步骤 flow：

Flow: WeeklyReport
  Step 1: 获取数据  →  Task (cron trigger)
  Step 2: 分析数据  →  Task (subagent, 等待 Step 1)
  Step 3: 生成报告  →  Task (等待 Step 2)
  Step 4: 发送邮件  →  Task (等待 Step 3)
  Step 5: 通知所有者 →  Task (flow 完成)

即使中间 gateway 重启，flow 的状态被持久化，重启后自动从断点恢复。

📅1. Cron 定时任务（已有部分脚本，但用法可以更深）

你目前有：NBA战报、 AI资讯、晨报、中东局势+股票监控

可以扩展的方向：

独立会话 Cron — 用 --session isolated 让 cron 在独立会话中运行，不影响主会话
定时深度分析 — 指定 --model 和 --thinking high 做复杂分析
webhook 触发 — 外部事件（GitHub PR、邮件到达）触发 agent 动作
Gmail 监听 — 新邮件自动推送到钉钉

# 添加一个独立会话的 CronJob
openclaw cron add \
  --name "深度周分析" \
  --cron "0 6 * * 1" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "对本周工作进行深度分析并给出建议" \
  --model "minimax-portal/MiniMax-M2.7" \
  --thinking high \
  --announce \
  --channel dingtalk

🤖">2. 多 Agent 团队（你已配置但可能未充分利用）

你已配置了 5 个 Agent：

Agent	角色	当前状态
main (Elaine)	PM 项目经理	活跃
sheldon	开发工程师	未启用
leonard	QA 测试工程师	未启用
raj	文档管理	未启用
howard	运维 Agent	未启用（heartbeat 关闭）

高级用法：

Subagent 嵌套 — 主 agent 派遣子 agent 并行工作，结果汇总后返回
深度 2 编排模式 — 主 → 编排 subagent → 工作 subagent，形成树形结构
Agent 间通信 — 通过 sessions_send 让不同 agent 互相传递信息
跨 agent QMD 搜索 — 配置 memorySearch.qmd.extraCollections 让一个 agent 搜索另一个 agent 的会话记录

💡 快速启用 Sheldon

# 打开 /config 界面启用 sheldon
/config set agents.list[1].enabled true

⚡">3. Subagent 并行任务（强大但你可能还没用过）

Subagent 允许你在一次对话中同时派遣多个后台 agent执行不同任务：

/subagents spawn sheldon "帮我写一个嵌入式bootloader代码"
/subagents spawn leonard "测试 sheldon 写的 bootloader 是否有 bug"

两个 subagent 并行运行，完成后各自返回结果。

关键参数：

--model — 为 subagent 指定模型（可以用更便宜的模型）
--thinking — 为 subagent 指定思考深度
--timeout — 设置超时（默认 900 秒）

💡 编排模式示例

主 agent 分配任务给 subagent A 和 B → A/B 并行执行 → 结果返回主 agent → 主 agent 汇总并报告给你

📋">4. 斜杠命令（Slash Commands）

OpenClaw 支持大量斜杠命令，你可能只用了其中一小部分：

命令	功能	你可能不知道
`/tasks`	查看后台任务看板	新 v2026.4.2 内置
`/btw`	快速侧问（不改变会话上下文）	非常适合临时确认
`/compact`	压缩会话历史，节省 token	长对话后必用
`/subagents`	管理 subagent	查看/杀死/转向 subagent
`/think`	调整思考深度	`/think high` 复杂问题用
`/model`	切换模型	可以临时用更强模型
`/usage`	查看 token 消耗	成本监控
`/export`	导出会话为 HTML	保存重要对话记录
`/context`	查看当前上下文构成	调试 token 消耗
`/tools`	查看当前可用工具	确认工具是否注入

🔒">5. 持续订单（Standing Orders）— 实现真正的自主代理

这是最容易被忽视的高级功能。Standing Orders 让你定义永久性的操作授权，agent 在没有你干预的情况下自主执行。

区别：

每次提醒 — "周五发周报" → 你每次都要说
Standing Order — "你负责周报，每周五执行" → 一次授权，自主演进

适用场景：

每天自动整理收件箱
监控股票异常波动并自动推送
定时健康检查服务器
自动备份重要文件

✅ 推荐：股票监控升级为 Standing Order

你的股票监控可以升级为 Standing Order：定义触发条件（±5%）、授权动作（推送钉钉）、升级规则（异常时立即通知）。

🪝">6. Webhook + Hooks — 外部事件驱动

OpenClaw 可以作为 HTTP webhook 端点，接收外部事件：

# 触发一个系统事件
curl -X POST http://127.0.0.1:18789/hooks/wake \
  -H 'Authorization: Bearer SECRET' \
  -H 'Content-Type: application/json' \
  -d '{"text":"新PR到达","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":"分析这个PR","name":"PRReview"}'

可用场景：

GitHub PR/Issue 事件 → 自动分析
服务器监控告警 → 自动诊断
定时外呼 → 任何 HTTP 触发器

📊">7. MCP（Model Context Protocol）支持

OpenClaw v2026.4.2 支持远程 MCP 服务器：

# 添加一个 MCP 服务器
/mcp set context7={"command":"uvx","args":["context7-mcp"]}

通过 MCP 可以连接：

上下文管理工具（Context7）
文件系统操作
数据库查询
自定义业务系统

🔧">8. 会话压缩（Session Compaction）

长对话会消耗大量 token。Compaction 会自动总结早期对话并压缩历史：

/compact

你配置了 compaction: { mode: "safeguard" }，这意味着只在必要时压缩。你也可以在 AGENTS.md 中定义压缩策略。

🌐">9. 多渠道连接

你目前只用钉钉。但 OpenClaw 支持大量渠道：

渠道	支持程度	适合场景
钉钉	已配置	当前主力
Telegram	未配置	海外资讯、快速沟通
Discord	未配置	社区、开发者群
WhatsApp	未配置	个人日常
Slack	未配置	工作团队
飞书	未配置	可能已在用
Matrix	未配置	去中心化聊天
Microsoft Teams	未配置	企业环境

🛡️">10. 安全加固（你的配置需要关注）

⚠️ 你的安全审计发现了 3 个严重问题

根据 openclaw security audit 的结果，你的配置存在以下高风险：

CRITICAL: groupPolicy: "open" 允许任何人执行操作
CRITICAL: 钉钉 DM 完全开放（dmPolicy: "open"）
WARN: 无认证速率限制（暴力破解风险）

建议立即修复：

# 限制钉钉 DM 为配对模式
/config set channels.dingtalk.accounts.main.dmPolicy "pairing"

# 启用速率限制
/config set gateway.auth.rateLimit '{"maxAttempts":10,"windowMs":60000,"lockoutMs":300000}'

# 收紧群组策略
/config set channels.dingtalk.accounts.main.groupPolicy "allowlist"

💾">11. 记忆系统（Memory）深度配置

你配置了 memory backend: qmd，但还有很多潜力未挖掘：

跨 Agent 搜索 — 配置 extraCollections 让 sheldon 搜索 main 的记忆
会话压缩 — QMD 会话自动摘要
选择性遗忘 — 定义哪些信息不应该被记住

优先级	行动项	原因
P0	修复安全配置（groupPolicy/dmPolicy）	当前配置暴露严重风险
P1	启用 Task Flow 编排你的 Cron 任务	让多个定时任务形成有逻辑的工作流
P1	将股票监控升级为 Standing Order	自主触发，不依赖心跳
P2	启用 subagent 并行处理	同时执行多任务，效率翻倍
P2	启用 Leonard（QA）和 Raj（文档）Agent	分担工作，建立工作流程
P3	添加 Telegram 或 WhatsApp 渠道	多渠道备份和日常使用
P3	配置 Gmail PubSub 邮件监听	重要邮件自动推送
P4	接入 MCP 服务器	扩展工具能力

模板1: 建立一个「每日站会」Task Flow

# 每天早上 9 点触发独立会话
openclaw cron add \
  --name "每日站会" \
  --cron "0 9 * * 1-5" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "执行每日站会流程：
1. 检查昨天的任务完成情况
2. 列出今天计划做的事情
3. 识别任何阻塞点
4. 将站会摘要更新到工作日志" \
  --announce \
  --channel dingtalk

模板2: 启用 Standing Order 自主监控

在你的 AGENTS.md 或 HEARTBEAT.md 中添加：

## Standing Order: 股票异常监控

**权限:** 监控伯特利(603596)和联赢激光(688518)，涨跌幅超过±5%时立即推送钉钉
**触发:** 每个心跳周期检查（仅 A 股交易时段 9:30-11:30, 13:00-15:00）
**升级规则:** 
  - ±5% 以内: 记录到日志
  - ±5% 以上: 立即钉钉推送告警
  - ±10% 以上: 同时触发深度分析
**授权动作:** 读取股票数据、推送钉钉消息、记录日志
**禁止动作:** 不要自动买卖、不要修改配置

模板3: 使用 Subagent 并行研究

# 假设你在主会话中：
/subagents spawn sheldon "研究 RISC-V 架构的最新发展动态"
/subagents spawn raj "整理这周的嵌入式行业新闻摘要"

# 主 agent 继续做其他事情，等 subagent 返回后汇总

模板4: 设置 Webhook 外呼

当 GitHub 有 PR 时自动分析（需要配置 GitHub Webhook）：

# 在 GitHub Webhook 设置中指向：
https://你的服务器:18789/hooks/agent

# OpenClaw 收到 PR 事件后自动执行：
"分析这个 PR：标题、描述、代码变更，给出是否推荐合并的意见"

⚠️ 立即需要修复的问题

运行以下命令（每次一条）：

# 1. 限制钉钉 DM 为配对模式（需要先让用户配对）
/config set channels.dingtalk.accounts.main.dmPolicy "pairing"

/* 
   注意: 改为 pairing 后，未配对的联系人将无法发消息。
   如果你需要保持开放，先设置为 allowlist:
   /config set channels.dingtalk.accounts.main.dmPolicy "allowlist"
   /config set channels.dingtalk.allowFrom ["你的钉钉ID"]
*/

/* 2. 启用网关速率限制 */
/config set gateway.auth.rateLimit='{"maxAttempts":10,"windowMs":60000,"lockoutMs":300000}'

💡 安全配置说明

将 groupPolicy 从 "open" 改为 "allowlist" 可以确保只有授权用户才能在群里@机器人。钉钉的 dmPolicy 建议使用 "pairing"（需要配对审批）。

功能域	你现在	完整能力
定时任务	5个脚本 Cron	独立会话 + Task Flow 编排 + Webhook 触发
多 Agent	5个配置，仅 main 活跃	并行 Subagent + 嵌套编排 + Agent 间通信
渠道	仅钉钉	+ Telegram / Discord / WhatsApp / Slack / 飞书
记忆	QMD 基本配置	跨 Agent 搜索 + 选择性记忆 + 会话压缩
安全	⚠️ 高风险	Rate limit + pairing + allowlist
触发器	定时 + 心跳	+ Webhook + Gmail + 外部事件
会话管理	默认模式	会话压缩 + 上下文控制 + 多会话并行
MCP	未使用	远程 MCP 服务器连接
Standing Order	未使用	自主代理 + 授权边界
斜杠命令	/tasks 等少量	完整命令集 + 自定义命令

🌟结语

OpenClaw 是一个极其强大的平台，你目前的使用可能只发挥了 30-40% 的能力。通过引入 Task Flow、Standing Orders、Subagent 编排和更完善的安全配置，你可以建立一个真正自主运行的 AI 工作流。

建议从 P0/P1 开始：先修复安全问题，然后建立你的第一个 Task Flow，最后逐步引入更多高级功能。

有问题随时问我！🌸

🤖 OpenClaw 任务流与高级玩法完全指南

📋 Part 1: 任务流（Task Flow）详解 — 新版本核心功能