Skip to main content
心跳系统让 IronClaw 在对话间隙也能主动执行任务。默认每 30 分钟读取工作区根目录的 HEARTBEAT.md,按清单执行。
你可以自定义心跳检查频率。

心跳会做什么

每次心跳触发时:
  1. 读取 HEARTBEAT.md
  2. 作为任务执行清单项
  3. 若有结果或发现,发送到已配置通知频道
  4. 将运行写入 heartbeat_state
如果 HEARTBEAT.md 不存在或为空,本次触发不执行任何动作。

HEARTBEAT.md 格式

建议使用 checklist:
条件语句(例如“仅周一执行”)由 LLM 结合当前日期解释。

通知行为

只有存在可行动信息时才发送通知;无结果时保持安静。可将摘要写入 heartbeat/latest.md 以便后续检索。

配置

如果频率过高导致 token 或 API 配额压力,建议将 HEARTBEAT_INTERVAL_SECS 调高到 3600 及以上。

常见问题

  • 确认 HEARTBEAT_ENABLED=true
  • 检查启动日志是否包含 heartbeat 启动信息
  • 检查 HEARTBEAT_INTERVAL_SECS 是否合理
  • 确认根目录存在 HEARTBEAT.md
  • 在 HEARTBEAT.md 中增加“仅有可执行项才通知”
  • 提高 HEARTBEAT_INTERVAL_SECS
  • 让清单更具体,减少噪声输出
  • 精简 HEARTBEAT.md 清单项
  • 提高触发间隔
  • 明确限制:例如“每次最多 5 次工具调用”