乐于分享
好东西不私藏

【附完整教程】我给 OpenClaw 装上任务系统

【附完整教程】我给 OpenClaw 装上任务系统

先关注后阅读,娇姐怕失去上进的你


用 OpenClaw 一段时间之后,开始遇到一个新问题——

Agent 越来越多,任务也越来越多。整理文章、写技术分享、分析竞品、生成周报……但这些任务散落在各处,没有统一的地方管,也不知道哪个 Agent 在跑什么,跑完了结果在哪。

于是我搭了一个 task-manager,专门负责任务调度。这篇文章把整个设计思路和实现方式记录下来。

核心思路

整个系统只有一个核心逻辑:飞书多维表格作为任务看板,task-manager 作为调度员,各个 Agent 作为执行者。

飞书多维表格(任务看板)

task-manager(调度员)

各个 Agent(执行者)

自动回写结果到飞书

重点:task-manager 是调度员,不是执行者。它只负责读取任务、分发、追踪结果、回写状态,不直接做内容整理、写作这些具体的事。

飞书表格结构

表格是整个系统的唯一事实来源,所有状态变更都回写到这里。字段设计如下:

字段
类型
说明
任务名称
文本
简短描述
描述
文本
详细说明,链接、要求等
负责 Agent
单选
content-curator / wechat-writer / sysmon…
优先级
单选
高 / 中 / 低
状态
单选
待处理 / 待澄清 / 进行中 / 已完成 / 失败
当前步骤
文本
实时进度
结果
文本
执行结果或飞书文档链接
失败原因
文本
出错时的详细信息

自动调度逻辑

task-manager 配置了 Heartbeat,每 30 分钟自动跑一次,执行四个步骤:

步骤一:检查卡住的任务

查询所有"进行中"的任务,找出更新时间超过 10 分钟的。检查子代理是否已经 announce 了结果,如果有,补充写入飞书并更新状态。

步骤二:检查超时任务

"进行中"超过 30 分钟的任务,自动标记为失败,记录失败原因。不自动重试,避免浪费 token,用户可以手动改回"待处理"重新提交。

步骤三:分发新任务

没有"进行中"的任务时,检查"待处理"队列,按优先级取出第一个,更新状态为"进行中",然后用 sessions_spawn 创建子代理去执行。

提示:一次只处理一个任务,不并发。避免 token 堆积,也让状态更容易追踪。

子代理怎么通信

这是整个系统最关键的设计——task-manager 和子代理之间靠 feishu_record_id 串联。

task-manager 创建子代理时,在任务描述末尾加一行:

整理《AI 产品榜》最新文章https://mp.weixin.qq.com/s/xxx提取核心观点,300字摘要feishu_record_id: rec_xxxxxx

子代理执行完成后,输出末尾同样保留这个 record_id。task-manager 检测到包含 record_id 的 announce 消息,提取出来,更新对应的飞书表格记录。

注意:用子代理而不是直接执行的原因——主 Agent 只做调度,上下文保持干净,避免任务越来越多之后出现 422 错误。子代理完成后自动清理,互不影响。

任务状态流转

待处理进行中已完成

task-manager 分发时

待处理待澄清

任务描述不清晰时

进行中失败

子代理失败或超时 30 分钟

实际用起来是什么感觉

用户视角很简单,在飞书表格加一行:

任务名称:整理公众号文章笔记到飞书

描述【这里的链接可以放更多,平时看到好的文章就可以放到这个任务多维表格中】:

整理以下3篇公众号文章,提取核心观点和要点,输出到飞书文档:

文章链接:

1. https://mp.weixin.qq.com/s/UJilVJlPFT5e0g2UMeCj

2. https://mp.weixin.qq.com/s/rrmdnYzBaFXwN3sMU1E

3. https://mp.weixin.qq.com/s/fjGd3mBJ2cHnR7Ctmx7

目标文档:https://fcnfwx5opw7x.feishu.cn/wiki/OUrVwcKJCi2OdUkkjvJcezA

负责 Agent:content-curator

优先级:

状态:待处理

然后等着就行。最多 30 分钟后 Heartbeat 触发,表格状态自动变成"进行中",完成后变成"已完成",结果直接写回到"结果"字段。

也可以手动触发:在飞书群里 @task-manager 说"检查任务",不用等下一次 Heartbeat。

自动写入飞书

成本怎么控制

这套系统跑起来之后,token 消耗是我最关心的问题。目前的控制方式:

  • 没有任务时 Heartbeat 只回复 HEARTBEAT_OK,几乎不消耗 token
  • 一次只处理一个任务,不并发
  • task-manager 使用 Haiku 模型,只有子代理用 Sonnet
  • 失败任务不自动重试,避免死循环烧钱
  • Heartbeat 工作时间设为 08:00 - 23:00,夜里不跑

还没解决的问题

这套系统现在能跑,但还有几个地方不完善,记录一下:

  • 不支持任务依赖
    :任务 A 完成后自动触发任务 B,目前还是手动
  • 定时任务
    :类似"每天 9 点执行"的场景,Heartbeat 可以做但还没配
  • 子代理飞书权限
    :有时候子代理说"飞书凭证未配置",需要 task-manager 接管写入,这块逻辑还在打磨

提示:如果你也在搭类似的系统,或者有更好的解法,欢迎在群里聊。这套东西还在迭代,边用边改。

完整配置(SOUL.md、HEARTBEAT.md、TOOLS.md、openclaw.json)我都放在三件套资料的案例文档中。

如何获取这个三件套(三件套我不定期持续更新):

有兴趣可以私kekohu获取。

1. 资料包(69.9元):《入门到精通》+《102个实战案例》+《避坑手册》,付款后立即发放飞书权限。

2. 付费社群(99元):入群即免费赠送上述全套资料包,额外享群内实操答疑、定期干货分享、同行交流,帮你快速避坑、高效落地。

今天就分享到这里了,假如对你有帮助,请关注点赞转发,谢谢大家。
关于openclaw的系列文章,可以参考如下,建议每一篇都认真阅读:
OpenClaw 长任务必读:用 Sub-Agent 隔离上下文,token 消耗降 85%
大白话讲清楚OpenClaw的记忆术
我的openclaw龙虾开始自己赚钱了
OpenClaw 龙虾玩家的安全指南
本地部署 OpenClaw 自动发布公众号:小白完整教程
OpenClaw 多 Agent 协作实战完全教程
OpenClaw 省 Token 实操手册:八个维度,节省 60–90%
OpenClaw 到底怎么跑?部署方式与玩法全景
彻底搞懂 OpenClaw 配置体系:这才是 AI Agent 的正确打开方式
本地部署 OpenClaw 自动发布小红书:小白完整教程
我的OpenClaw 多Agent 会主动发来 “上班打卡”
12类人群必装的OpenClaw Skills
OpenClaw 排错指南
不写代码,如何让 OpenClaw Agent 学会新技能
OpenClaw 实战:从0到1搭建你的云端AI工作流
看看这个龙虾速度,就知道这OpenClaw有多火,速度跟上
不写代码,如何让 OpenClaw Agent 学会新技能
OpenClaw 曲线救国:通过 CLI 后端使用 Claude 模型
OpenClaw 官方 53 个技能完整指南:功能详解 + 风险评估 + 安装建议
OpenClaw 多代理配置指南:让 AI 团队帮你同时干多件事
OpenClaw 完全指南:从零搭建你的 AI 员工团队
如何申请 Brave Search API 密钥并配置 OpenClaw
OpenClaw 实战操作指南:12大热门应用案例详细教程
飞书跟openclaw集成实操教程
OpenClaw 命令完整手册
用上了openclaw,跟telegram能双向通信了
【该文为openclaw输出】OpenClaw超简单且免费的安装实操教程
关于娇姐,可以参考这些文章:
高考的坚持与感恩:我心中的那座桥,跨越了命运
40 + IT女从荣耀离职:找工作碰壁、陪娃焦虑的日子里,我靠 AI 公众号找到了自我
关注娇姐,持续分享AI干货和资讯,偶尔分享生活碎碎念