🧠✨ OPENCLAW HEARTBEAT
🔹 🎯 CONCEPTO CLAVE
💡 Heartbeat = ejecución automática periódica del agente.
⏱️ Funciona como un “latido” que lo activa solo.
🤖 No necesita que el usuario escriba.
🚀 Convierte al agente en proactivo.
👉 Idea central:
El agente no espera → actúa por sí mismo cada cierto tiempo.
🔹 ⚙️ ¿CÓMO FUNCIONA?
🔄 En cada ciclo ocurre lo siguiente:
1️⃣ Se ejecuta automáticamente (ej: cada 30 minutos).
2️⃣ Lee el archivo HEARTBEAT.md.
3️⃣ Interpreta instrucciones.
4️⃣ Decide qué hacer.
🧾 RESULTADO POSIBLE
✔️ Si NO hay nada relevante:
→ HEARTBEAT_OK.
⚡ Si detecta algo importante:
→ ejecuta acciones o envía mensajes.
🔹 🧠 ARCHIVO CLAVE: HEARTBEAT.md
📌 Es el cerebro del comportamiento automático.
📝 Define:
• Qué revisar.
• Qué priorizar.
• Qué acciones ejecutar.
🧩 EJEMPLOS TÍPICOS
📧 Revisar emails nuevos.
🌐 Consultar APIs.
🚨 Generar alertas.
🔁 Automatizar tareas repetitivas.
👉 Es donde diseñás el rol autónomo del agente.
🔹 ⚙️ CONFIGURACIÓN PRINCIPAL
⏱️ FRECUENCIA
• "30m" → cada 30 minutos.
• "1h" → cada 1 hora.
• "0m" → desactivado.
🎯 DESTINO DE MENSAJES
• "none" → no envía nada.
• "last" → responde al último contacto.
⚙️ OPCIONES AVANZADAS
🪶 lightContext → usa menos contexto.
🕒 activeHours → limita horarios.
📩 directPolicy → controla envíos directos.
🔹 🧩 LÓGICA INTERNA (PROMPT)
📜 Regla base del agente:
👉 “Lee HEARTBEAT.md”.
👉 “Si no hay nada → responde HEARTBEAT_OK”.
🎯 OBJETIVO
🚫 Evitar ruido.
🚫 Evitar acciones innecesarias.
✅ Mantener comportamiento consistente.
🔹 🚀 IDEA PRINCIPAL
💡 Heartbeat convierte al agente en:
✔️ Autónomo.
✔️ Proactivo.
✔️ Programado.
✔️ Capaz de monitorear continuamente.
👉 Es como tener:
🧠 “Un asistente que se despierta solo y revisa todo por vos”.
🔹 🛠️ CASOS DE USO REALES
🔄 Monitorear APIs (SIMA, IBC, etc.).
📊 Revisar bases de datos.
🚨 Enviar alertas automáticas.
📩 Generar reportes periódicos.
🌐 Integrar sistemas externos.