OpenClaw Heartbeat 指南
OpenClaw Heartbeat 指南
Heartbeat（心跳）是让 OpenClaw 从"被问才回答"变成"自己定期检查并告诉你哪里出问题"的功能。
这个页面教你在基本安装和第一个 channel 已经跑通之后，如何设置 heartbeat。如果你还没完成这些前置步骤，请先回到：
Heartbeat 到底做什么
Heartbeat 按固定间隔运行一次周期性检查。每次检查可以：
- 确认 Gateway 仍在运行
- 确认 channel 仍在连接
- 运行一条简单测试 prompt 并检查响应
- 向某个 channel 发送状态更新
- 按计划触发一个 workflow
它不是一个复杂的监控系统。它是一个轻量的"一切都还活着吗"信号。
为什么你需要 heartbeat
没有 heartbeat 的时候，你只有在以下情况才会发现出了问题：
- 你发了一条消息但没有收到回复
- 一个定时任务悄悄停了
- Gateway 崩溃了但几个小时没人注意到
有了 heartbeat，你能获得：
- 一个周期性的"系统还活着"信号
- 什么东西停止工作时的早期预警
- 定时输出的投递渠道（每日摘要、提醒等）
好的第一个 heartbeat 配置
从最简单的 heartbeat 开始：
1. 选一个频率
第一个 heartbeat 用一个简单间隔：
- 每 6 小时是一个好的默认值
- 不要一上来就每 5 分钟——太吵且没用
- 每天一次也行，适合低频使用的场景
2. 选一个任务
你的第一个 heartbeat 任务应该很简单：
- 向一个 channel 发一条"我还活着"消息
- 或者跑一次基本 health check 并报告结果
不要让第一个 heartbeat 做复杂工作。保持简单，这样你才能确认调度本身是否生效。
3. 选一个投递渠道
把 heartbeat 输出发送到：
- 你经常看的私有 Discord channel
- 你自己的 Telegram 聊天
- 或者任何你会定期查看的渠道
不要把 heartbeat 输出发到一个没人看的 channel。
4. 定义什么叫"成功"
一个好的 heartbeat 应该有清晰的成功条件：
- Gateway 做出了响应
- 测试消息已生成
- 输出已投递到目标 channel
如果其中任何一项失败，heartbeat 应该暴露错误，而不是静默跳过。
第一个 heartbeat 跑通后可以加什么
当你有一个 heartbeat 稳定运行后，以下是值得继续加的：
每日摘要 heartbeat
每天跑一次，汇总：
- 哪些 workflow 跑了
- 哪些成功了，哪些失败了
- 有没有值得回顾的错误
监控 heartbeat
每几小时跑一次，检查：
- Gateway 状态
- channel 连通性
- 模型提供商可用性
- 上一次成功消息的时间戳
Workflow 触发 heartbeat
按计划运行，触发：
- 每日新闻摘要
- GitHub issue 汇总
- SEO 监控检查
- 任何场景页里的周期性 workflow
常见错误
频率太高
每 5 分钟发一次"我还活着"只会制造噪音。从每 6 小时或每天一次开始。
单个 heartbeat 塞太多任务
一个 heartbeat 同时检查健康、跑摘要、发警报、触发三个 workflow，一旦失败就很难排查。每个 heartbeat 只做一件事。
没有投递目标
跑了但没有输出到任何地方的 heartbeat 是隐形的。一定要定义输出去哪。
没有失败处理
如果 heartbeat 本身失败了（Gateway 挂了、channel 断了），谁来通知？把 heartbeat 输出发送到不依赖同一基础设施的 channel 来解决这个问题。
Heartbeat 排错
Heartbeat 完全不跑
- 检查调度器是否在 workspace 配置中配置了
- 确认 Gateway 正在运行（heartbeat 通过 Gateway 运行）
- 验证 cron 或 interval 语法是否正确
Heartbeat 跑了但没有输出
- 检查 task prompt 是否已定义
- 确认投递 channel 已连接
- 查看 Gateway 日志中 heartbeat 执行时的错误
Heartbeat 太吵
- 增大间隔
- 减少每次 heartbeat 的检查数量
- 过滤输出，只报告失败，不报告每次成功
接下来该看什么
- OpenClaw Use Cases — 使用 heartbeat 的真实 workflow 模板
- OpenClaw SEO 监控 — 基于 heartbeat 的监控 workflow
- OpenClaw 每日新闻摘要工作流 — 按计划运行的摘要 workflow
- OpenClaw Setup Checklist — 如果基本安装还没确认，先回到这里