OpenClaw 配置文件详解 06:HEARTBEAT.md —— 定时任务与自动化检查

摘要： HEARTBEAT.md 是 OpenClaw 的「定时检查清单」，让 AI 在固定时间主动执行任务。配置好后， AI 会变成「主动型助手」，不用你提醒也会做事。

一、这是什么文件？

HEARTBEAT.md = 定时检查任务清单

它定义： – 什么时间触发检查（心跳间隔） – 触发后执行什么任务 – 什么时间段保持安静（不打扰用户） – 哪些任务可以自主执行，哪些需要请示

位置： C:\Users\admin\.openclaw\workspace\HEARTBEAT.md

触发机制： 由 Gateway 定时发送 heartbeat 事件， AI 读取此文件后执行任务

二、当前配置解析

你的 HEARTBEAT.md 当前内容：

状态： 空配置（仅注释）

含义： – 没有定义具体任务 – AI 收到 heartbeat 后，无事可做 – 回复 HEARTBEAT_OK 表示「检查完成，无异常」

三、 Heartbeat 工作机制

3.1 触发流程

Gateway 定时发送 heartbeat          ↓ AI 读取 HEARTBEAT.md          ↓ 执行文件中定义的任务          ↓ 无事则回复 HEARTBEAT_OK 有事则执行并报告结果 

3.2 安静时间

尊重安静时间：23:00-06:00 除非紧急，否则别打扰。 

作用： 避免 AI 在深夜发送通知打扰用户。

配置位置： 此规则定义在 AGENTS.md 中， heartbeat 机制遵循此规则。

四、可以配置什么任务？

4.1 数据监控类

示例：公众号数据监控

## 每日检查- [ ] 检查昨日公众号文章阅读量、分享率 - [ ] 阅读量低于 500 时，发送提醒 - [ ] 每周日生成周报表格 

AI 执行逻辑： 1. 调用公众号 API 获取数据 2. 比对阈值（ 500 ） 3. 低于阈值 → 发送消息提醒 4. 每周日 → 汇总 7 天数据生成报表

4.2 内容创作类

示例：热点监控 + 选题生成

## 每日热点- [ ] 每天早上 8:00 抓取微博、百度、知乎热搜 - [ ] 生成热点汇总报告 - [ ] 推荐 3 个适合写作的选题 - [ ] 保存到 D:\MyCode\Work\hot-{date}.md 

AI 执行逻辑： 1. 调用各平台 API 抓取热搜 2. 生成 Markdown 报告 3. 结合你的领域推荐选题 4. 保存到指定目录

4.3 文件管理类

示例：工作区整理

## 每周整理- [ ] 每周一上午 10:00 检查 D:\MyCode\Work - [ ] 超过 30 天的文件移动到归档目录 - [ ] 大于 100MB 的文件单独列出 - [ ] 生成整理报告 

AI 执行逻辑： 1. 扫描指定目录 2. 按文件时间排序 3. 移动老旧文件到归档目录 4. 生成整理报告发送给用户

4.4 健康提醒类

示例：休息提醒

## 健康提醒- [ ] 每工作 50 分钟，提醒休息 5 分钟 - [ ] 晚上 23:00 后，如果检测到还在工作，提醒休息 - [ ] 周末早上 10:00 发送「周末愉快，别太拼」 

AI 执行逻辑： 1. 检测用户活动状态（需配合其他工具） 2. 计时 50 分钟 → 发送提醒 3. 深夜检测 → 发送休息提醒 4. 周末定时 → 发送关怀消息

4.5 数据备份类

示例：自动备份

## 每日备份- [ ] 每天晚上 23:00 备份工作区到网盘 - [ ] 备份完成后检查文件大小 - [ ] 备份失败时发送告警 

AI 执行逻辑： 1. 调用备份脚本 2. 检查备份文件是否正常 3. 失败时发送告警消息

五、最佳实践模板

模板 1 ：公众号运营监控

## 每日检查（9:00 AM）- [ ] 检查昨日文章数据（阅读量、分享率、完读率） - [ ] 阅读量<500 → 发送分析建议 - [ ] 分享率>5% → 记录到成功案例库  ## 每周检查（周一 10:00 AM）- [ ] 生成周报表格（7 天数据汇总） - [ ] 分析本周最佳/最差文章 - [ ] 推荐下周选题方向  ## 每月检查（1 号 11:00 AM）- [ ] 生成月度数据报告 - [ ] 更新 MEMORY.md 中的业绩数据 - [ ] 检查 cover_media_id 是否需更新 

模板 2 ：个人效率管理

## 晨间检查（8:00 AM）- [ ] 推送今日热点汇总 - [ ] 列出今日待办（从待办列表提取） - [ ] 提醒今日截止时间（Deadline）  ## 午间检查（13:00 PM）- [ ] 检查上午任务完成情况 - [ ] 未完成的任务重新排期  ## 晚间检查（18:00 PM）- [ ] 生成今日工作总结 - [ ] 整理今日学习笔记到 Obsidian - [ ] 规划明日待办  ## 深夜检查（23:00 PM）- [ ] 如果检测到仍在工作，发送休息提醒 - [ ] 否则不发送任何消息（静默检查） 

模板 3 ：项目进度跟踪

## 每日站会（9:30 AM）- [ ] 收集各子项目昨日进度 - [ ] 识别延期风险 - [ ] 生成站会报告发送群里  ## 周回顾（周五 17:00 PM）- [ ] 汇总本周完成情况 - [ ] 对比周初目标 - [ ] 生成本周完成/未完成清单 - [ ] 发送周报给项目负责人  ## 里程碑检查（每个项目节点前 3 天）- [ ] 检查里程碑完成情况 - [ ] 识别风险点 - [ ] 发送提醒「还有 3 天到节点，当前进度 XX%」 

六、配置方式

6.1 通过 AGENTS.md 定义规则

HEARTBEAT.md 本身不直接配置定时任务，而是通过 AGENTS.md 定义 AI 收到 heartbeat 后的行为：

## Heartbeat  收到 heartbeat 时，读 'HEARTBEAT.md' 执行检查任务。没事做就回"HEARTBEAT_OK'.  尊重安静时间：23:00-06:00 除非紧急，否则别打扰。  heartbeat 期间可以自主做的事: -整理 memory 文件 -检查项目状态 -更新 MEMORY.md (从日志中提炼) 

6.2 Gateway 定时任务配置

真正的定时任务在 Gateway 配置中定义（config.yaml 或通过 cron 命令）：

openclawcronadd--schedule"0 9 * * *"--kind"systemEvent"--text"HEARTBEAT"

schedule 格式： Cron 表达式 – 0 9 * * * = 每天早上 9:00 – 0 */2 * * * = 每 2 小时 – 0 23 * * * = 每天 23:00

七、避坑指南

坑 1 ：任务定义太模糊

❌ 错误：

- [ ] 检查项目状态 

问题： AI 不知道「检查」什么、怎么算「异常」

✅ 正确：

- [ ] 检查 GitHub 仓库是否有未处理的 Issue（超过 3 天） - [ ] 有则列出 Issue 链接和标题 - [ ] 无则回复 HEARTBEAT_OK 

坑 2 ：任务太多太频繁

❌ 错误：每小时检查一次，每次执行 10 个任务

后果： – Token 消耗快 – 消息过多打扰用户 – AI 执行容易出错

✅ 正确： – 关键任务每天 1-2 次 – 非关键任务每周 1 次 – 总任务数控制在 5 个以内

坑 3 ：没有设置安静时间

❌ 错误： 24 小时都发送通知

后果： 深夜通知打扰休息

✅ 正确： – 在 AGENTS.md 中定义安静时间（ 23:00-06:00 ） – 非紧急任务避开安静时间 – 深夜只执行静默检查

坑 4 ：任务执行后不反馈

❌ 错误： AI 执行完任务，用户不知道

问题： 用户不知道 AI 做了什么

✅ 正确： – 任务完成后发送简要报告 – 异常情况立即通知 – 正常情况可只回复 HEARTBEAT_OK

八、行动清单

任务 1 ：定义你的第一个 heartbeat 任务（ 20 分钟） – 想一个你每天重复做的检查任务 – 写成任务清单格式（参考模板） – 写入 HEARTBEAT.md

任务 2 ：设置定时触发（ 15 分钟） – 用 openclaw cron add 添加定时任务 – 设置合适的时间（避开安静时间） – 测试是否触发

任务 3 ：观察 + 迭代（持续） – 观察 3 天，看 AI 是否按时执行 – 发现执行不到位 → 调整任务描述 – 任务太多 → 删减优先级低的

下一篇预告：IDENTITY.md + TOOLS.md —— 身份标识与本地环境配置

全平台： 公众号/视频号/小红书 → 李宏阳讲 AI