告别被动问答：OpenClaw 心跳机制（HEARTBEAT）完整配置与避坑指南

如果只是把 OpenClaw 当作一个“你问我答”的聊天工具，那你可能只发挥了它 10% 的功力。想要让它从“被动待命的工具”进化为“主动出击的数字管家”，核心秘诀就在于配置它的 HEARTBEAT（心跳机制）。

心跳机制的底层由 OpenClaw 的 Cron System 驱动。今天，我们将手把手教你如何配置这套调度引擎，并为你扫清社区里无数开发者踩过的“致命天坑”。

在动手之前，我们需要先了解两个极其重要的底层机制，这能帮你避开 99% 的启动崩溃问题：

1. 配置 Schema 校验严格（#28015 天坑）： OpenClaw 的主配置文件（）在启动时会进行极其严格的 Zod Schema 校验。千万不要将具体的任务指令直接写进主配置文件中！ 否则 Gateway 网关会直接报错罢工。
2. Gateway 内存覆盖机制： 具体的任务数据其实储存在 中。但 Gateway 在运行时会将该文件加载进内存，并在有变动时回写。如果你在运行期间用文本编辑器强行修改它，系统重启或内存回写时，你的手动修改会直接被旧数据覆盖。

最佳实践：主配置只管“开开关”，添加任务全靠 CLI 命令行。

OpenClaw 的主配置是一个 JSON5 文件，默认位于 。我们需要在这里开启定时调度功能。

打开配置文件：

在顶层配置中添加（或修改） 区块：

💡 老鸟提示：如果你熟悉修改JSON文件，修改完这里后即可保存退出，跳过新手无痛包的阅读，然后按照第二步添加后续的任务。

新手无痛包：完整对照示例

OpenClaw 的主配置是一个 JSON5 文件（默认位于 ）。对于新手来说，最大的坑就是找不准所谓“顶层配置”的位置，导致 JSON 格式被破坏。

所谓的“顶层配置”，指的是与 、、 这些同级的位置。为了让你一目了然，请参考下方这个完整的示例。

打开配置文件后，请找到文件末尾（比如在 或 区块的上方），小心地将 区块粘贴进去，并注意补齐上一行的逗号：

💡 致命避坑提醒： 修改完毕并保存退出后，后续所有具体的巡检任务（比如每十分钟干什么），都绝对不要再往这个 JSON 文件里手写了！请严格按照第二步，使用命令行工具来添加。

对于真正的“数字管家”而言，我们不需要它每次都死板地执行固定命令，而是希望它具有“人格”和“记忆”。

你可以先在本地建立一个 文件（例如存放在 ），在里面写好你希望它扮演的角色、聊天的语气，以及当前阶段它需要关注你的哪些状态。

控制台里那个黄色的警告（Doctor warnings）非常关键。它的意思是：

“你把 Telegram 群组/私聊策略设置成了 （白名单模式），但是你的白名单是空的！这会导致所有发给机器人的消息都会被静默丢弃。”

既然你在命令行里使用了 ，说明你的 Telegram 用户 ID 是 。我们需要把你加到主配置文件的白名单里，否则即使心跳触发了，消息也发不到你手机上。

修复方法： 打开主配置文件：

找到 区块，并在里面加上 。修改后应该是这样的：

保存退出，并重启一下 OpenClaw 网关让配置生效。

接下来，通过 OpenClaw CLI 将这个高频聊天任务注入调度器：

运行以下命令，建立高频心跳：

挂载成功后，由于它是静默执行的，你在 Telegram 里是看不到它被唤醒的（除非它决定要主动找你说话）。

为了确认这只“小猫”真的在后台按照你的 跑起来了，我建议你紧接着运行下面这个命令来实时监控它的心跳日志：

（ 参数会让日志持续滚动输出，你可以盯着看 5 分钟，观察它第一次被唤醒时调用工具的完整思考过程。）

哎呀，我的锅！这里的 CLI 语法我记混了。

OpenClaw 的报错提示 意思是： 命令后面不需要加 这个词作为参数。它默认会输出整个网关的全局日志。

1. 查看所有实时日志（推荐）： 直接把 这个词去掉，保留 参数即可实时追踪：

(在这个界面里，你能看到整个 OpenClaw 系统的运转，包括你的聊天记录流转和后台的 Cron 任务触发。)

2. 如果嫌日志太乱，想专门盯“小猫”： 因为你是在 macOS 环境下，可以结合系统的 命令，只过滤出跟这次心跳任务相关的日志。运行这个：

现在日志挂起来了，为了不干等，我们可以openclaw 配置人为制造一点“小状况”，看看这只“小猫”在下一个 5 分钟到来时，会不会顺着你的 规则主动跳出来找你。

你可以挑一个在工作区执行：

方法 A：给它制造点“没收尾的工作”（触发规则 1 和 4） 在你的 OpenClaw 工作区目录（）里，随便新建或修改一个文件但不提交：

当下一个 5 分钟的心跳触发时，它会在后台运行 ，发现这个未跟踪的文件。根据规则，它应该会通过 Telegram 主动向你汇报：“发现工作区有未记录的新文件 ，需要我帮你整理吗？”

方法 B：在你们的 Telegram 聊天里“假装有急事” 现在直接在 Telegram 里发给它一句： “我明天早上 9 点要开一个很重要的早会，但资料还没整理完。” 由于你使用了 ，它是有这句话的记忆的。下一个 5 分钟心跳触发时，它读取 里的规则（“发现明确的重要待办、风险”），应该会主动发消息提醒你处理这份资料。

赶紧试试看！盯着你的日志窗口，看看 5 分钟倒计时结束后，它会作何反应！

如果你采用“每 5 分钟唤醒一次”的策略，请务必仔细阅读这一段！

每 5 分钟一次，意味着一天 24 小时它要在后台主动“思考”并向 API 发起 288 次请求！ 更可怕的是，因为它挂载在你的主会话（）中，每一次唤醒，它都会携带你们之前所有的聊天历史作为上下文。

如果你背后挂载的是高端云端大模型（如 GPT-4o 或 Claude 3.5 Sonnet），随着聊天记录的增加，单次心跳消耗的 Token 会呈指数级膨胀。它绝对会在你毫无察觉的情况下，每天烧掉几十甚至上百美元！

💰 架构级省钱与防破产策略：

对于这种 5 分钟级别的高频陪聊心跳，极其建议通过本地部署 Ollama 运行开源免费模型（如 Llama 3 或 Qwen）。 这不仅响应速度极快、完全免除了隐私泄露的担忧，更重要的是——不管一天聊 288 次还是 2880 次，完全零成本！ 你可以把昂贵的云端 API 留给写代码、数据分析等真正需要深度逻辑推理的单次指令。