很多人第一次部署OpenClaw后都会看到一个配置heartbeat不少人第一反应是这个要不要关会不会一直烧 APIHeartbeat.md 是干嘛的甚至有些人直接把它关掉了。但其实如果你想让AI Agent 真正自动工作那心跳机制就是整个系统的核心。这篇文章我用最通俗的方式给你讲清楚OpenClaw 的心跳机制到底是什么要不要开启如何正确配置以及 90% 新手都会踩的坑一、什么是 OpenClaw 心跳机制简单来说Heartbeat 定时唤醒 AI Agent。OpenClaw 会按照设定的时间间隔自动让 Agent 执行一次检查。比如默认配置every: 30m意思是每 30 分钟执行一次任务循环。每次执行大致流程是1 读取 HEARTBEAT.md 2 检查是否有需要处理的任务 3 如果有任务 → 执行 4 如果没有 → 返回 HEARTBEAT_OK如果只是HEARTBEAT_OK系统会直接丢弃这条消息不会打扰用户。所以从本质上来说Heartbeat 就是 AI 的“循环任务调度器”。二、没有 Heartbeat 会发生什么很多人以为 Agent 会自己运行。其实不是。如果没有 heartbeat系统行为是这样的你帮我检查邮件 AI好的 然后结束Agent 不会再主动做任何事情。但如果开启 heartbeat每 30 分钟 检查 - 邮件 - GitHub 通知 - 日程 - 系统状态如果发现问题AI → 通知你所以 Heartbeat 解决的是让 AI 从“被动工具”变成“主动助手”。三、Heartbeat 默认配置是什么OpenClaw 默认配置是every: 30m也就是一天运行 48 次。配置一般在config.json5示例{ agents: { defaults: { heartbeat: { every: 30m, target: last } } } }主要参数参数作用every执行间隔target消息发送位置model使用的模型activeHours限定运行时间includeReasoning是否包含推理四、Heartbeat 必须开启吗答案是不一定。常见有三种使用方式。1 关闭 Heartbeat如果你只是把 OpenClaw 当聊天工具every: 0m适合手动 AI不需要自动化想省 API 费用因为默认配置30 分钟一次 48 次 / 天如果用 GPT 或 Claude成本可能很高。2 开启 Heartbeat自动化玩法如果你想做自动监控邮件自动抓取热点自动发布内容自动运维系统那必须开启 heartbeat。它是 Agent 自动化运行的基础。3 降低频率推荐方案大多数个人用户可以这样配置every: 1h或者every: 2h这样一天执行1224 次成本会低很多。五、HEARTBEAT.md 是什么Heartbeat 每次都会读取一个文件workspace/HEARTBEAT.md这个文件就是Agent 的任务清单。例如# Heartbeat Checklist - check email inbox - check GitHub notifications - check system health - if urgent - notify me每次 heartbeat 触发时Agent 就会按这个清单执行。如果这个文件是空的OpenClaw 会直接跳过 heartbeat。六、Heartbeat 和 Cron 的区别OpenClaw 其实有两种任务机制。Heartbeat周期检查例如每 30 分钟检查邮件Cron固定时间任务例如每天早上 8 点发送日报简单理解Heartbeat 循环巡逻 Cron 定时任务七、推荐配置个人部署如果你是自己部署 OpenClaw我比较推荐这个配置{ agents: { defaults: { heartbeat: { every: 1h, model: ollama/llama3:1b, target: none, lightContext: true } } } }这样有几个好处成本低Agent 仍然保持运行不会频繁打扰八、新手最常见的三个坑1 API 费用突然爆炸很多人不知道默认是48 次 / 天解决办法heartbeat.model 本地模型比如使用Ollama。2 HEARTBEAT.md 太长Heartbeat 每次都会读取这个文件。如果内容太长Token 消耗会明显增加。建议控制在 200 tokens 以内。3 以为 Agent 会自动工作很多人部署完后发现Agent 什么都没干。原因其实很简单没有 heartbeat没有循环触发Agent 就不会主动执行任务。九、总结OpenClaw 的自动化体系其实非常清晰Heartbeat 周期检查 Cron 定时任务 Skills 执行能力 Workspace 状态存储从架构上理解Heartbeat 就是 AI Agent 的“心跳循环”。只有它在持续跳动Agent 才能真正活起来。