HEARTBEAT.md en OpenClaw es un archivo del workspace del agente que sirve para definir una pequeña lista de chequeo periódica que el sistema revisa durante los heartbeats. OpenClaw lo inyecta como parte del contexto del proyecto cuando existe, junto con otros archivos como AGENTS.md, TOOLS.md, IDENTITY.md y USER.md.
En la práctica, un heartbeat es un turno programado de la sesión principal del agente. Por defecto corre cada 30 minutos, y su objetivo es que el agente revise cosas que podrían requerir atención sin esperar un mensaje tuyo. No crea tareas en segundo plano: eso se maneja aparte con automatizaciones o cron.
La plantilla oficial de HEARTBEAT.md es muy simple: si lo dejás vacío, OpenClaw omite esas llamadas de heartbeat; si agregás texto o tareas, el agente lo usa como guía para revisar periódicamente lo que le indiques. La documentación también recomienda mantenerlo corto para no gastar tokens de más.
Una forma simple de entenderlo es esta:
HEARTBEAT.md= qué revisar- Heartbeat = cuándo revisarlo
- Cron / tareas desacopladas = trabajos separados del chat principal
Ejemplo conceptual de uso dentro de HEARTBEAT.md:
# Revisar en cada heartbeat
- Ver si hay emails importantes sin responder
- Ver si hoy hay eventos de calendario próximos
- Ver si hay recordatorios pendientes
- Avisar solo si hay algo que requiera acción
Entonces, la respuesta corta sería: HEARTBEAT.md es el archivo donde le decís a OpenClaw qué chequeos proactivos querés que haga en cada latido programado del agente.