OpenClaw 框架深度指南：HEARTBEAT 机制与定时任务配置

OpenClaw 框架深度指南

OpenClaw 是一个本地运行的自主 AI 代理框架，能通过 WhatsApp、Telegram 等聊天应用互动，并支持后台主动监控钱包、盯盘链上异动及发送警报。

其核心机制包括 Heartbeat（心跳清单） 和 Cron Jobs（定时任务）。合理配置可避免 Token 浪费、提醒重复及上下文污染。

第一部分：HEARTBEAT.md 是什么？

HEARTBEAT.md 是 OpenClaw 的核心配置文件之一（通常位于 workspace 根目录，如 ~/.openclaw/workspace/HEARTBEAT.md）。

作用

• 变被动为主动：Agent 每隔固定时间（默认 30 分钟）自动'心跳'一次。
• 指令注入：每次心跳读取 HEARTBEAT.md 中的 checklist，作为用户指令喂给模型。
• 智能过滤：模型判断有事则处理/提醒，没事则静默（输出 HEARTBEAT_OK，Gateway 自动吞掉消息）。

心跳原理（完整 Agent Turn）

1. Gateway 定时触发心跳事件。
2. 构建上下文：加载主会话历史 + SOUL.md（性格）+ AGENTS.md（规则）+ MEMORY.md（长期记忆）。
3. 注入指令：将 HEARTBEAT.md 内容作为'用户消息'注入（Prompt 大意：'严格读 HEARTBEAT.md，跟随它检查，不要脑补旧任务。如果没事，回复 HEARTBEAT_OK'）。
4. 模型推理：可能调用工具（查邮箱、日历、链上、X、硬盘等）。
5. 输出处理：
   • 无事 → HEARTBEAT_OK（静默）。
   • 有事 → 总结/警报 → 通过 Target（Telegram 等）发送。
6. 记录存储：本次 Turn 的思考与工具结果存入主会话历史，避免重复。

一句话：心跳 = 自动给自己发一条带 HEARTBEAT.md 的消息，然后完整跑一次 Agent。带记忆、智能过滤，但频率过高会累积上下文并消耗 Token。

心跳与聊天的冲突处理

OpenClaw 使用 Lane Queue（通道队列） 设计，同一 Session 内所有任务严格串行：

• 用户消息：高优先级，插队到队列头部，优先处理。
• 心跳任务：低优先级，若主 Lane 忙（正在聊天或运行长任务），则排队等待。
• 体验：聊天零延迟；聊完后心跳紧接着执行，可能补充'刚才查到的大额转账警报'。

频率设置

在 config.json（路径通常为 ~/.openclaw/config/openclaw.json 或 gateway/config.json）中调整：

{
  "agents": {
    "defaults":