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 将导致任务归属不可追溯，影响多智能体审计