核心用法
Heartbeat Manager 是专为 OpenClaw 设计的 Agent 任务监控管理系统，需配合 OpenClaw 心跳机制同步运行。核心工作流包含三大指令：
- `beat`（每30分钟执行）：例行任务检查（daily.md）、待办超期检测（todo.md @due:HH:MM）、ongoing.json 状态机监控、智能超时分析（区分正常推进与完全卡死）、邮件检查、Git同步、健康度评分计算（0-100分）、MASTER.md 主控表更新
- `reset`（每日00:00）：发送昨日日报邮件、重置 daily.md、清理已完成 ongoing 任务
- `weekly`（每周日23:59）：生成本周健康度趋势与任务统计周报
智能超时分析机制
系统通过对比任务 ETA 与实际进度，智能识别两种状态：正常推进（允许合理延迟）vs 完全卡死（BLOCK 状态），避免机械式超时告警。
健康度评分体系
五维度加权评分：Daily 完成率（25%）、Todo 完成率（20%）、Ongoing 状态（25%）、邮件处理（15%）、Git 同步（15%）。连续 3 次低于 60 分触发邮件告警。
---
显著优点
1. 默认安全的设计哲学：Git 功能完全默认关闭（git.enabled: false），邮件功能需用户手动配置凭证后才启用，杜绝开箱即用的安全风险
2. 纵深防御的 Git 安全：subprocess.run 强制使用参数列表且禁止 `shell=True`，彻底杜绝 shell 注入；commit message 经控制字符净化；auto_push 独立开关
3. 凭证隔离机制：邮件凭证存储于 config/.env，该文件明确永不纳入版本控制或共享
4. 细粒度副作用控制：所有外部操作（IMAP/SMTP/Git/日志）均可通过配置单独禁用
5. OpenClaw 原生集成：通过 HEARTBEAT.md 配置即可无缝接入 OpenClaw 心跳触发器
---
潜在缺点与局限性
1. 邮件功能依赖外部凭证：若不配置 Gmail App Password，邮件告警/日报/周报功能完全不可用，仅保留本地监控能力
2. Gmail 生态绑定：当前仅原生支持 Gmail SMTP/IMAP，其他邮件服务商需自行适配
3. 本地文件副作用不可关闭：workspace/ 目录下的 MASTER.md、state.json 等核心状态文件写入为强制行为
4. Git 功能需预配置环境：开启前需确保本地仓库已初始化、remote 已配置，对非技术用户存在门槛
5. 单点运行依赖：未提及多实例并发或分布式状态同步机制
---
适合人群
- OpenClaw 重度用户：需要配套任务监控与自动化日报的 Agent 使用者
- 自律型开发者：希望通过量化评分（健康度）驱动任务完成率的个人开发者
- 小型团队负责人：需要轻量级项目状态可视化与周期性汇总（周报）的 1-3 人团队
---
常规风险
| 风险场景 | 说明 | 缓释措施 |
|---------|------|---------|
| 邮件凭证泄露 | `.env` 文件被误提交 | 文件明确列入 `.gitignore`，文档多次警示 |
| Git 误操作推送 | 开启 `auto_push` 后向错误 remote 推送 | 默认关闭，开启前强制确认 remote 配置 |
| 健康度评分误导 | 机械评分无法反映任务实际价值 | 评分仅作参考，结合人工判断 |
| 心跳执行失败累积 | OpenClaw 心跳中断导致检查遗漏 | 状态文件持久化，重启后可恢复 |
| 时间敏感任务漂移 | 系统时钟偏差导致 @due 判断错误 | 建议配合 NTP 时间同步 |