很多人第一次部署 OpenClaw 后，都会看到一个配置：

heartbeat

不少人第一反应是：

这个要不要关？
会不会一直烧 API？
Heartbeat.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

这样一天执行：

12～24 次

成本会低很多。

---

五、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 才能真正活起来。