#13 OpenClaw 心跳机制

💓 什么是心跳机制？

在前面的文章中，我们了解了 OpenClaw 如何响应用户的指令执行各种操作。但在真实的使用场景中，AI 助手不应该只是「被动等待」——它应该能够主动发现问题、保持连续性、在空闲时做有意义的工作。这就是 OpenClaw 心跳机制（Heartbeat）的设计目标。

心跳机制就像人的心跳一样，定期、规律地触发 AI 的「思考和检查」循环。即使没有用户发来消息，AI 也会在心跳触发时醒来，检查环境状态，执行预设任务，或者在发现重要事项时主动联系用户。

🔄 心跳的工作原理

心跳机制的运行非常简洁：

1. 系统按预设间隔（通常 30 分钟左右）触发心跳
2. AI 收到心跳提示，读取 HEARTBEAT.md 获取任务清单
3. AI 按清单逐项检查，执行必要操作
4. 如果没有需要关注的事项，AI 回复 HEARTBEAT_OK 保持静默
5. 如果发现重要事项，AI 主动向用户发送通知

📋 HEARTBEAT.md：你的心跳清单

HEARTBEAT.md 文件位于工作区根目录，是你告诉 AI 在心跳时应该检查什么的清单。它的格式非常灵活：

# HEARTBEAT.md

## 定期检查
- [ ] 检查邮箱是否有紧急未读邮件
- [ ] 查看未来 24 小时内的日历事件
- [ ] 检查 GitHub 通知和 PR 评论

## 项目维护
- [ ] 检查博客是否有新评论
- [ ] 监控服务器状态

## 社交媒体
- [ ] 检查 Twitter 提及和私信
- [ ] 查看 Discord 消息

AI 不会每次都检查所有项目——它会根据上次检查的时间和优先级，智能地选择本轮要检查的内容。

📊 状态跟踪：heartbeat-state.json

为了避免重复检查和资源浪费，OpenClaw 使用一个状态文件来记录上次检查的时间：

{
  "lastChecks": {
    "email": 1703275200,
    "calendar": 1703260800,
    "github": 1703250000,
    "social": null
  }
}

这个状态文件位于 memory/heartbeat-state.json，AI 会根据时间戳判断哪些检查已经过时需要更新，哪些可以跳过。

⏰ 心跳 vs 定时任务：何时使用哪个？

OpenClaw 同时支持心跳和定时任务（Cron），但它们的适用场景不同：

使用心跳的情况

• 多个检查可以批量进行（收件箱 + 日历 + 通知）
• 需要来自最近消息的对话上下文
• 时间可以稍微漂移（每 30 分钟左右一次即可）
• 想通过合并定期检查来减少 API 调用

使用定时任务的情况

• 精确时间很重要（「每周一早上 9:00 整」）
• 任务需要与主会话历史隔离
• 想为任务使用不同的模型或思考级别
• 一次性提醒（「20 分钟后提醒我」）

🔔 何时主动通知用户？

心跳机制的一个重要设计原则是「有帮助但不烦人」。AI 只在以下情况下主动联系用户：

• 紧急邮件到达 — 标记为紧急或高优先级的未读邮件
• 日历事件即将来临 — 距离开始时间不到 2 小时
• 重要发现 — 发现了用户可能感兴趣的信息
• 长时间未交流 — 距上次对话超过 8 小时

而在以下情况下，AI 会保持安静：

• 深夜时段（23:00-08:00）除非紧急情况
• 用户明显忙碌 — 正在密集对话中
• 没有新发现 — 上次检查后一切正常
• 刚刚检查过 — 距上次检查不到 30 分钟

🧠 记忆维护：心跳期间的自我进化

心跳机制不仅仅是检查外部信息，还是 AI 进行记忆维护的好时机。每隔几天，AI 可以利用心跳期间：

1. 阅读最近的 memory/YYYY-MM-DD.md 文件
2. 识别值得长期保留的重要事件、经验教训
3. 用提炼的学习内容更新 MEMORY.md
4. 清理 MEMORY.md 中不再相关的过时信息

这就像人类回顾日记并更新心理模型——每日文件是原始笔记，MEMORY.md 是精心整理的智慧。

⚡ AI 在心跳期间可以主动做的事情

心跳期间，AI 不需要等待用户指令就可以执行以下操作：

• 读取和组织记忆文件
• 检查项目状态（git status 等）
• 更新文档和笔记
• 提交并推送自己的更改
• 审查和更新 MEMORY.md

💡 最佳实践

• 精简清单 — HEARTBEAT.md 不要太长，每次心跳检查 3-5 项即可
• 分类管理 — 按类别组织检查项，便于 AI 理解优先级
• 定期审视 — 每周回顾 HEARTBEAT.md，移除不再需要的检查项
• 避免过度 — 检查频率不是越高越好，找到合适的平衡点

📚 总结

心跳机制让 OpenClaw 从「被动应答」进化为「主动守护」。通过定期检查、智能通知和记忆维护，AI 能够在你不说话的时候也保持高效运转。这正是 OpenClaw 所倡导的——AI 不应该只是一个工具，而应该是一个可靠的伙伴。

在最后一篇文章中，我们将探讨如何使用树莓派作为远程节点，将 OpenClaw 的能力扩展到家庭网络的各个角落。