核心功能
task-ledger 是 OpenClaw 生态中的长任务持久化工作流工具包，将易失的聊天上下文转换为 durable 的任务对象。通过 JSON 格式的检查点文件、结构化日志和输出目录，实现跨会话的任务状态保存与恢复。
显著优点：
- 持久化保障：任务文件存于
tasks/目录，支持断连/重启后的精确恢复，避免"上下文丢失"灾难 - 关系感知：内置 parent/child 任务关联、依赖链检查（
task-ready.py），防止下游任务在依赖未完成时启动 - 执行绑定：可记录
process.sessionId、subtask.sessionKey、cron.jobId等外部执行引用，实现跨系统追踪 - 回滚就绪：任务 Schema 预留 rollback 元数据，为危险操作（重启、部署）提供撤销基础
- 丰富的 CLI 工具集：14+ 个脚本覆盖创建、推进、验证、导出、诊断全生命周期
- 专业模板：内置网关重启、服务部署、飞书文档同步等高风险工作流示例
潜在局限：
- 依赖本地文件系统（
tasks/,logs/,outputs/），分布式场景需自行同步 - 恢复时依赖
task-verify.py校准现实状态，自动化程度受限于外部系统的可观测性 - 无内置分布式锁，并发修改同一任务文件可能产生冲突
- Python3/Bash 依赖对纯 Windows 环境不够友好
适合人群：运维工程师、SRE、自动化工作流设计者、需要"可审计、可交接、可复盘"长任务的团队。
常规风险：检查点与现实状态漂移（需严格执行 verify 协议）；手动修改 JSON 可能破坏 Schema；敏感任务日志需自行加密或清理。