核心用法
Task Ledger 是 OpenClaw 执行原语之上的持久化工作流层，将易失的聊天上下文转化为结构化的任务对象。核心工作模式为：创建任务骨架 → 分阶段执行 → 实时更新检查点 → 异常时恢复续跑。
典型触发场景：任务预计运行超过5分钟、超过3个阶段、使用后台 exec/sessions_spawn/cron、涉及外部副作用（重启/部署/维护）、需要多代理并行协作、需依赖检查或短形式报告。
目录结构：tasks/存放任务检查点，logs/记录执行日志，outputs/存储产物报告。
并行模式推荐：单父任务 + 多子任务树结构，避免共享写入冲突。
显著优点
1. 故障韧性：中断后可基于检查点精准恢复，无需从头重跑
2. 可审计性：完整的执行历史、绑定关系、阶段流转全留痕
3. 结构化协作：父/子任务树天然支持多代理并行与依赖管理
4. 人机友好：短形式摘要优先，长报告文件化，支持多种导出格式
5. 生态集成：与 ACP、子代理、exec、cron 等原语深度绑定，非替代而是增强
潜在局限
1. 认知负担：小型任务引入持久化层反而增加复杂度，官方明确不建议滥用
2. 存储开销：任务检查点、日志、产物持续累积需定期归档清理
3. 一致性风险：任务文件是"缓存的真相"，现实状态与检查点可能分歧，需主动校验修正
4. 学习曲线：14步操作协议、专用脚本集、JSON Schema 需一定掌握周期
5. 生态锁定：深度绑定 OpenClaw 特定目录结构与执行原语，迁移成本较高
适合人群
- 运维/SRE 需执行带风险的长时变更（重启网关、服务部署）
- 多代理协作场景下需协调并行任务与依赖顺序
- 需可恢复、可审计的定时批处理或数据同步任务
- 追求"断点续传"体验而非"重来一遍"的可靠性敏感用户
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| 状态漂移 | 外部系统变化后任务检查点未同步 | 执行 `task-verify` 校验现实状态，分歧时修正检查点 |
| 并发写冲突 | 多代理同时修改同一任务文件 | 严格遵循父-子任务树模式，避免共享写目标 |
| 存储膨胀 | 历史任务与日志无限增长 | 建立归档策略，定期执行清理或导出 |
| 误恢复 | 未校验直接续跑导致重复操作 | 遵循"现实优先"原则，先验证再恢复 |
| 模板误用 | 直接套用示例未适配实际场景 | 理解模板意图后修改，勿盲目复制 |
安全等级 S 基于设计层面的故障恢复机制与显式校验协议，但实际安全性高度依赖用户遵循操作规范的严格程度。