HZL

HZL 是一款专为智能体设计的本地优先任务账本工具，核心定位是解决 OpenClaw 缺乏原生任务追踪能力的痛点。与 Claude Code 的 TodoWrite 或 Codex 的 update_plan 不同，OpenClaw 仅依赖内存和 markdown 文件，而 HZL 通过持久化存储实现了跨会话边界的工作恢复。

核心用法

HZL 采用 CLI 驱动的工作流，围绕项目（Project）、任务（Task）、子任务（Subtask）三级结构展开。单智能体场景使用统一项目，多智能体场景则按角色划分项目池（如 research、writing、coding），通过 --next 和 --project 实现池路由而非直接分配给特定智能体。关键命令包括 hzl workflow run start（会话启动与过期租约恢复）、hzl task claim（任务认领）、hzl task checkpoint（进度快照）、hzl workflow run handoff/delegate（工作交接）。

显著优点

• 会话无关性：checkpoint 机制确保工作在任何中断后可被其他智能体无缝接管
• 多智能体原生支持：租约（lease）机制防止任务 orphaned，stuck 检测支持故障恢复
• 显式依赖管理：跨项目依赖支持复杂协作流程，配合 hzl dep list 可视化阻塞点
• 灵活的部署模式：本地 SQLite 优先，可选 Turso 云同步；内置 Web 仪表盘便于人工监督
• 破坏性操作保护：init --force 和 prune 等危险命令需显式 --yes 确认

局限性与缺点

• 无自动编排：不主动分配任务或分解工作，需上层编排器驱动
• 调度简单：仅支持优先级 + FIFO，无智能排程或负载均衡
• 生命周期钩子有限：仅 on_done 触发 webhook，stuck 检测等需轮询
• 依赖 CLI 熟练度：缺乏图形化任务创建向导，新手需要学习曲线
• v2+ 功能依赖：workflow 命令需要较新版本，旧版本需回退到手动模式

适合人群

• 使用 OpenClaw 且需要跨会话持久化工作状态的开发者
• 运行多智能体系统（如研究-写作-编码流水线）的团队
• 需要明确任务交接边界和故障恢复机制的 AI 工作流设计者
• 偏好本地优先、可审计、可自托管的数据管控方案的用户

常规风险

• 数据丢失风险：hzl init --force --yes 会无确认删除全部数据；task prune --yes 永久清除历史
• 租约竞态条件：若多智能体使用相同 --agent ID 或租约过期时间设置不当，可能导致任务重复认领或 orphaned
• 依赖循环：跨项目依赖需定期 hzl validate 检查，否则可能产生死锁
• hook 延迟：on_done 通知非即时，依赖 cron 轮询（2-5 分钟），不适合实时性要求极高的场景
• 身份混淆：未使用 distinct --agent ID 将导致任务归属不可追溯，影响多智能体审计

HZL是一款专为AI Agent设计的多层级任务账本系统，核心价值在于解决OpenClaw原生缺乏任务状态持久化的问题。它采用本地优先架构，通过SQLite数据库存储项目和任务数据，支持跨会话恢复工作状态。

核心功能包括：项目池路由（按角色分配项目实现多Agent协作）、租赁机制（lease防止任务孤儿）、检查点系统（checkpoint实现会话恢复）、依赖管理（支持跨项目依赖）以及工作流命令（handoff/delegate实现任务委托）。单Agent场景使用统一项目池，多Agent场景按角色拆分项目池。

显著优点：① 会话边界持久化——任务状态不随会话结束而丢失；② 多Agent安全协调——租赁机制+过期检测防止任务冲突；③ 轻量无依赖——纯CLI工具，无需服务端；④ 灵活路由——支持定向分配和池化竞争两种模式；⑤ 审计完整——记录agent身份、检查点历史、完成通知。

潜在局限：① 无自动编排——需外部系统触发Agent执行；② 无任务自动分解——依赖人工或外部规划；③ 简单调度策略——仅支持优先级+FIFO，无智能负载均衡；④ 通知延迟——on_done钩子依赖2-5分钟轮询；⑤ 无原生权限系统——依赖文件系统权限控制数据库访问。

适合人群：使用OpenClaw进行多步骤复杂任务的技术用户、需要多Agent协作的自动化工作流构建者、对任务可追溯性有要求的研发团队。不适合简单一次性任务或需要实时提醒的场景。

常规风险：① 破坏性命令误用——init --force和prune --yes可删除全部数据；② 数据库文件丢失风险——需定期备份；③ Token泄露——云同步时--auth-token可能暴露于shell历史；④ 租赁配置不当——过期时间过长导致任务滞留，过短增加竞争；⑤ 跨项目依赖循环——需手动运行hzl validate检测。