核心用法
Task Tracker Pro 是一款面向 Agent 工作流的任务持久化管理工具,核心理念为"不信任对话记忆,只信任文件"。当用户下达多步骤任务(如"帮我做个网站")、查询进度或启动新对话时,系统会自动在 ~/.openclaw/workspace/tasks/ 目录下创建任务文件,将任务拆解为可执行的 checklist,并在每完成一步后立即落盘更新状态。
关键操作流程:
1. 建档拆解:接收任务后分析并拆解为具体步骤,创建结构化 Markdown 文件
2. 实时追踪:执行一步、打勾一步,强制格式为 - [x] 步骤描述 ✅ 执行人 MM-DD HH:MM
3. 中断恢复:新对话启动时自动扫描 tasks/ 目录,读取未完成任务并定位到待执行步骤
4. 归档管理:完成后经检查清单核对,移至 done/ 目录留存,支持审计追溯
多Agent协作模式: 通过「多Agent分工」表格明确各 Agent 职责范围,步骤标注负责方,实现并行执行与责任可追溯。
显著优点
- 断电不丢活:状态完全落盘,对话中断、服务重启均可无缝恢复
- 进度透明化:文件即看板,用户可随时查看原始 Markdown 了解精确进度
- 协作规范化:明确的分工表和打勾机制,避免多 Agent 重复执行或遗漏
- 审计可追溯:执行日志强制留痕,阻塞标记(
⚠️ 阻塞)清晰记录卡点 - 极简依赖:纯文件系统实现,无外部数据库或网络服务依赖
潜在局限与风险
- 文件系统脆弱性:依赖本地磁盘 I/O,若工作目录被误删或权限变更将导致状态丢失
- 无并发控制:多进程/多实例同时读写同一任务文件可能引发竞态条件
- 无自动备份:归档仅作目录移动,无版本历史或云端同步机制
- 粒度权衡难度:"一口气能做完"的主观标准可能导致步骤过粗(难追踪)或过细(管理负担重)
- 人工检查依赖:最终验收环节依赖「检查清单」人工核对,无自动化验证机制
适合人群
- 需要长时间运行、跨会话保持的复杂任务场景
- 多 Agent 协作开发、分工明确的团队工作流
- 对任务可追溯性、审计日志有要求的生产环境
- 对话上下文长度受限或频繁重启的部署场景
常规风险
- 路径硬编码风险:工作目录
~/.openclaw/workspace/tasks/若用户主目录不可写将直接失败 - 文件名冲突:项目名作为文件名,特殊字符或重复命名可能导致覆盖或创建失败
- 僵尸任务堆积:未完成的长期阻塞任务可能无限期占用 tasks/ 目录,缺乏自动清理机制