核心用法
Heartbeat Manager 是一款专为 AI Agent 设计的自动化任务监控与管理系统，通过定期"心跳"检查确保任务持续推进。核心功能包括：
1. 定时心跳检查（beat）：每30分钟自动检查 daily.md 例行任务、todo.md 待办事项（含 @due:HH:MM 超期检测）、ongoing.json 任务状态机，执行智能超时分析区分"正常推进"与"完全卡死"。
2. 健康度评分系统：基于5个维度计算0-100分综合评分——Daily完成率(25%)、Todo完成率(20%)、Ongoing状态(25%)、邮件处理(15%)、Git同步(15%)，连续3次低于60分自动邮件告警。
3. 报告生成：每日00:00发送昨日完成日报，每周日23:59发送周报汇总，均需配置邮件凭证。
4. OpenClaw集成：可通过在 HEARTBEAT.md 中添加命令实现与 OpenClaw 内置心跳同步触发。
显著优点
- 智能超时分析：不仅检测超期，还能判断任务是"正常推进中"还是"完全卡死"，减少误报。
- 灵活配置：邮件、Git、日志功能均可独立开关，核心心跳功能零依赖运行。
- 安全设计：Git功能默认关闭，
subprocess.run禁止shell=True，commit message 净化控制字符，避免注入风险。 - 多维度可视化：健康度评分机制让 Agent 状态一目了然。
潜在缺点与局限性
- 凭证配置门槛：邮件告警、报告功能需用户自行配置Gmail App Password，对非技术用户存在学习成本。
- Gmail绑定：当前仅原生支持Gmail SMTP/IMAP，其他邮件服务商需手动修改配置。
- 本地文件依赖：核心功能依赖
workspace/目录下的 markdown/json 文件，无数据库支持，不适合高并发场景。 - Git操作风险：虽默认关闭，但开启后自动commit/push可能产生意外提交，需确保
.gitignore配置完善。
适合人群
- 使用 OpenClaw 或其他 Agent 框架需要任务健康监控的个人开发者
- 需要自动化日报/周报生成的远程工作者或自由职业者
- 希望量化 Agent 工作效率的 AI 研究者与早期采用者
常规风险
- 凭证泄露风险：
config/.env文件需妥善保管，避免意外提交到公共仓库。 - 邮件发送频率：若健康度持续低迷，可能触发频繁告警邮件，建议合理设置阈值。
- 文件系统副作用：运行时会持续写入
workspace/和logs/目录，长期使用需关注磁盘空间。