核心用法
Task Tracker 是一套基于文件系统的持久化任务管理方案，核心解决对话Agent在复杂多步骤任务中的状态丢失问题。其工作流程包含四个关键环节：
1. 任务拆解建档
- 收到多步骤任务后，自动分析并拆解为可执行步骤
- 在
~/.openclaw/workspace/tasks/目录创建Markdown格式的任务文件 - 采用标准化模板，包含步骤清单、多Agent分工表、检查清单和执行日志
2. 实时进度追踪
- 执行每步后立即更新文件：
- [ ]改为- [x] ✅ 执行人 时间 - 执行日志同步追加关键决策和问题记录
- 阻塞步骤标注
⚠️ 阻塞：原因，便于后续恢复
3. 中断自动恢复
- 新对话启动时自动扫描任务目录
- 读取未完成任务，定位到首个未完成步骤继续执行
- 实现"对话断了，任务不断"的可靠性保障
4. 完成归档机制
- 所有步骤完成后逐项核对检查清单
- 状态标记为
🟢 已完成并移至done/目录 - 保留完整执行历史，便于审计复盘
显著优点
- 状态持久化：完全不依赖对话上下文，文件即真相
- 协作透明：多Agent场景下分工明确、责任可追溯
- 断点续作：任意时刻中断均可精准恢复
- 轻量无依赖：纯Markdown+文件系统，无外部服务依赖
潜在局限
- 文件系统约束：依赖特定目录权限，跨设备需同步机制
- 并发冲突：多进程同时写同一任务文件可能产生竞态条件
- 粒度平衡：步骤拆分需要经验，过粗失去追踪意义，过细增加管理负担
- 无可视化界面：纯文本形态，对非技术用户不够友好
适合人群
- 需要执行复杂多步骤任务的AI Agent开发者
- 追求任务可审计、可复盘的企业级应用场景
- 多Agent协作系统中需要明确分工和责任边界的场景
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据丢失 | 目录误删或磁盘故障 | 定期备份tasks/目录 |
| 状态不一致 | 异常中断导致勾未打但工作已做 | 执行前写日志，恢复时交叉验证 |
| 权限问题 | 目录无写入权限 | 首次使用检测并提示用户授权 |
| 并发写入 | 多实例同时操作同一任务 | 建议单实例主Agent协调，或引入文件锁 |