核心功能
task-ledger 是一套面向 OpenClaw 的任务持久化工具包，将原本脆弱的聊天上下文转化为可恢复、可审计的 durable task objects。其核心能力包括：
| 能力维度 | 具体功能 |
|---------|---------|
| **断点续传** | 基于 JSON checkpoint 的任务状态持久化，支持中断后恢复 |
| **故障恢复** | 验证当前 reality 与 checkpoint 一致性，冲突时优先修正 |
| **回滚追踪** | 内置 rollback metadata，支持有风险操作的可逆记录 |
| **依赖调度** | 父子任务关联、readiness-aware 启动、start-if-ready 模式 |
| **混合报告** | 短摘要优先，长报告落地文件，支持多格式导出 |
显著优点
- 上下文免疫：任务状态脱离对话上下文，可 survive restarts、disconnects
- 生产级鲁棒：专为 5min+ 长任务、多阶段流水线、后台 exec/subagents/cron 设计
- 风险可控：restart/deploy 等高危操作配备专用模板与回滚元数据
- 可观测性强：支持
task-ls-tree、task-graph-export、task-doctor等诊断工具
潜在局限
- 本地依赖重：依赖
python3和bash，需 bootstrap 复制 toolkit 文件 - 手动一致性维护：需主动执行
verify与resume-summary，非全自动自愈 - Schema 约束：任务文件需遵循特定 JSON schema，有一定学习成本
- OpenClaw 专用：与 OpenClaw 生态深度绑定，通用性受限
适合人群
- 运行长耗时自动化运维任务（部署、重启、数据同步）的工程师
- 需要任务可审计、可交接、可图形化追踪的团队
- 频繁遭遇网络中断或上下文丢失导致任务中断的用户
常规风险
- checkpoint 漂移：若 reality 变化但未及时 verify，可能基于脏状态继续执行
- 权限与副作用：task 涉及后台进程、subagent、cron，需关注执行权限与资源泄漏
- 文件系统污染：
tasks/、logs/、outputs/目录持续写入，需定期归档清理 - 误恢复风险：resume 时若未正确比对 reality，可能导致重复执行或跳过关键步骤