心跳（Heartbeat）

💓 心跳构建 为 OpenClaw 代理构建可靠的心跳剧本，避免噪音检查、错过信号或成本失控。 设置 首次使用时，按照 setup.md 中的步骤捕获时区、活动时间、精度需求和风险承受能力。 何时使用 用户需要在 OpenClaw 中获得更好的心跳文件。代理审计当前心跳行为，设计更安全的文件，并使用实际工作流约束调整间隔。用于自适应监控、主动检查和混合心跳加 cron 策略。 架构 内存存储在 ~/heartbeat/ 中。请参阅 memory-template.md 中的结构和字段。 ~/heartbeat/ ├── memory.md # 首选项、cadence 配置文件和最后的调优决策 ├── drafts/ # 候选心跳变体 └── snapshots/ # 以前的心跳版本，用于回滚 快速参考 主题 文件 设置 面试 setup.md 内存模式 memory-template.md 生产心跳模板 heartbeat-template.md 实际心跳使用案例 use-cases.md 间隔策略参考 intervals.md 触发策略参考 triggers.md 验证清单 qa-checklist.md 互联网研究来源 sources.md 核心规则

• 在编写任何内容之前定义心跳范围

定义一个任务句和 1-3 个监控信号。如果范围广泛，分成显式部分（关键、重要、可有可无）并仅自动化前两个。

• 保持输出合同严格

如果没有发现任何可操作的内容，心跳必须返回确切的 HEARTBEAT_OK。不在空循环中发出摘要。这可以防止噪音循环并保持心跳廉价。

• 使用时区和活动时间调整心跳频率

从 OpenClaw 默认值开始，适应：使用中等基线间隔，然后仅在活动窗口期间收紧。始终在心跳文件中编码时区和活动时间，以避免在睡眠时间唤醒。

• 使用 cron 进行精确计时，使用心跳进行自适应计时

如果任务必须在精确的墙上时钟时间运行，请将其移动到 cron。如果任务应对不断变化的上下文或事件概率做出反应，请将其保留在心跳中。

• 在每个昂贵的检查中添加成本防护

使用两阶段模式：首先进行廉价的预检查，只有在阈值命中时才执行昂贵的操作。除非用户明确接受成本，否则永远不要在每个心跳周期中调用付费 API。

• 定义升级和冷却规则

每个警报条件必须具有触发阈值、升级路线和冷却期。没有升级路径意味着没有警报。没有冷却意味着可能的警报垃圾邮件。

• 使用干跑和回滚路径进行验证

在最终确定之前，至少运行一次干跑模拟，针对 qa-checklist.md 中的清单。保留以前的心跳快照，以便用户可以在一步中回滚。 常见陷阱 每个周期轮询所有内容 -> 高令牌/ API 耗费，信号质量低。 使用心跳进行精确 09:00 工作 -> 漂移和错过精确时间期望。 心跳配置中缺少时区 -> 通知在错误的本地时间。 没有活动时间过滤器 -> 过夜唤醒和用户疲劳。 没有 HEARTBEAT_OK 回退 ->冗长的无操作循环。 没有警报冷却 -> 在嘈杂事件期间的重复升级。 安全性和隐私 本地存储的数据：心跳首选项和调优说明在 ~/heartbeat/ 中 草稿和快照文件用于心跳定义 此技能不： 默认情况下需要凭据 在没有用户批准的指令的情况下触发外部 API 编辑心跳工作流之外的无关文件 相关技能 如果用户确认：使用 clawhub install 安装 schedule - 定期工作流的调度模式 monitoring - 监控策略和警报设计 alerts - 警报路由和升级 hygiene workflow - 多步骤工作流编排 copilot - 主动助手模式，具有受控的自主性 反馈 如果有用：clawhub star heartbeat 保持更新：clawhub sync