OpenClaw(前 Clawdbot / Moltbot)深度指南:从 HEARTBEAT.md 入门到 Cron Jobs 进阶,打造你的 24/7 Crypto AI 哨兵
2026 年初 OpenClaw 这个项目火爆 GitHub(短短几天 10w+ star),它本质上是一个本地运行的、自主的 AI 代理框架,能通过 WhatsApp/Telegram 等聊天 App 跟你互动,还能主动后台干活:监控钱包、盯 X 大V、查链上异动、发日报警报……
但真正让它从“聊天机器人”变成“数字分身”的,是两个核心机制:Heartbeat(心跳清单) 和 Cron Jobs(定时任务)。很多人一开始搞混,导致 token 烧爆、提醒重复、上下文污染。今天我把从零到进阶的所有坑和玩法全扒一遍,尤其是针对 crypto 盯盘/警报/新闻的实际配置。
第一部分:Heartbeat.md 是什么?为什么它是 OpenClaw 的“灵魂”?
HEARTBEAT.md 是 OpenClaw 最核心的配置文件之一(位于 workspace 根目录,通常 ~/.openclaw/workspace/HEARTBEAT.md)。
它的作用超级简单却强大:
- 让你的 AI agent 从被动变主动:不是只等你发消息才醒,而是每隔固定时间(默认 30 分钟)自动“心跳”一次。
- 每次心跳,agent 会读取 HEARTBEAT.md 里的 checklist,作为“本次用户指令”喂给模型。
- 模型判断:有事就处理/提醒你,没事就安静(通常只输出 HEARTBEAT_OK,Gateway 会自动吞掉这条消息,不打扰你)。
中文社区最常见的叫法:心跳清单、心跳检查表、主动巡检清单。
心跳一次到底发生了什么?(完整 agent turn 原理)
不是简单脚本执行,而是在主会话(main session)里追加一次完整的 agent 推理循环:
- Gateway 定时触发心跳事件。
- 构建上下文:加载主会话全部历史(你之前的聊天、工具结果) + SOUL.md(性格) + AGENTS.md(规则) + MEMORY.md(长期记忆)。
- 把 HEARTBEAT.md 内容当成“用户消息”注入(默认 prompt 大意:“严格读 HEARTBEAT.md,跟随它检查,不要脑补旧任务。如果没事,回复 HEARTBEAT_OK”)。
- 模型完整思考:可能调用工具(查邮箱、日历、链上、X、硬盘等)。
- 输出:
- 没事 → HEARTBEAT_OK(静默,不发给你)。
- 有事 → 总结/警报 → 通过 target(Telegram 等)发给你。
- 这次 turn 的所有记录(思考、工具结果)存入主会话历史,下次心跳/聊天还能“记住”避免重复。
一句话:心跳 = 自动给自己发一条带 HEARTBEAT.md 的消息,然后完整跑一次 agent。带记忆、智能过滤,但频率高会累积上下文 + 烧 token。
心跳 vs 你正在聊天,会不会冲突?
不会真正冲突(没有并行覆盖、状态污染),因为 OpenClaw 用 lane queue(通道队列) 设计:同一个 session 所有任务严格串行。
- 你发消息 → 高优先级,插队到队列头部,尽快处理。
- 心跳 → 低优先级,如果主 lane 忙(你在聊或 agent 跑长任务),心跳排队等。
- 结果:你聊天时几乎零延迟;聊完后心跳紧接着跑,可能发一条“刚才查到的大额转账警报”。
- 轻微感觉:agent 回复你问题后,偶尔紧接一条心跳提醒(队列顺序导致)。
实际体验:大多数人觉得“它在后台默默干活挺好”,不会乱。
怎么设置频率?(30m vs 1h 等区别)
在 config.json(~/.openclaw/config/openclaw.json 或 gateway/config.json)里改:
{ "agents":{ "defaults":