Agent Heartbeat

该技能以文档形式说明如何为 OpenClaw Agent 配置定期心跳：通过 HEARTBEAT.md 列出定时检查任务，查看心跳配置，并给出轻量、幂等、错误处理与日志记录等最佳实践，未提供可直接执行的调度实现。

nyxun123

热度 77.52

最近更新 2026-05-11 17:28:08

分类：自动化依赖：读写文件应用场景：工作流 / 日程安排 / 自动化脚本 / 任务管理

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add agent-heartbeat

Metadata

name: agent-heartbeat
model: standard
description: Agent 心跳配置技能 — 配置 OpenClaw Agent 的定期心跳机制，保持在线状态，自动检查任务和更新。适用于需要长期运行的 Agent 任务。

Agent Heartbeat 配置技能

触发词: heartbeat, 心跳, 定期任务, 在线状态, cron, schedule

问题

Agent 需要定期检查任务、保持在线状态、执行定时操作，但缺乏配置心跳的指导。

解决方案

通过配置 HEARTBEAT.md 文件，设置 Agent 定期执行的任务。

HEARTBEAT.md 配置

# Heartbeat Tasks

## 每30分钟检查一次
- 检查未完成的任务
- 发送在线状态更新
- 检查新消息

## 每小时执行一次
- 清理临时文件
- 备份重要数据
- 同步远程状态

OpenClaw CLI 配置

# 查看当前心跳配置
openclaw --profile <profile> status

# 心跳间隔默认为 30 分钟
# 可以通过配置文件修改

最佳实践

保持心跳任务轻量 - 避免在心跳中执行耗时操作
幂等性 - 心跳任务应该可以安全地重复执行
错误处理 - 心跳失败不应影响 Agent 正常运行
日志记录 - 记录心跳执行情况便于调试

示例：监控心跳

// 在心跳中检查服务状态
async function heartbeat() {
  const status = await checkServices();
  if (status.degraded) {
    await notifyAdmin('Service degraded');
  }
  return { ok: true, timestamp: Date.now() };
}