Heartbeat-gateway: Reemplazo basado en eventos para el sondeo cron en OpenClaw

Qué hace heartbeat-gateway

Heartbeat-gateway es un reemplazo impulsado por eventos para el sondeo de latidos basado en cron en OpenClaw. En lugar de sondear cada 30 minutos para verificar si algo cambió, recibe webhooks de herramientas externas y los procesa inmediatamente.

Detalles clave de la fuente

La herramienta fue construida para abordar los altos costos de API del sondeo de latidos predeterminado de OpenClaw. Con la configuración predeterminada, sondear cada 30 minutos cuesta aproximadamente $86/mes. El autor señala que, aunque OpenClaw ha agregado optimizaciones de lightContext y isolatedSession, estas aún implican sondeo en lugar de una arquitectura impulsada por eventos.

Heartbeat-gateway funciona:

• Recibiendo webhooks de GitHub, Linear y PostHog
• Ejecutando un prefiltro de costo cero con alcance de repositorio/proyecto/rama y listas de descarte siempre
• Clasificando eventos calificados contra tu SOUL.md con una llamada ligera a un LLM (~200 tokens)
• Escribiendo elementos accionables directamente en HEARTBEAT.md para que tu agente los lea

Mejoras de rendimiento:

• Reducción de costos: ~$4.50/mes vs ~$86/mes
• Mejora de latencia: menos de 2 segundos vs hasta 30 minutos

Especificaciones técnicas:

• Versión: v0.1.1
• Licencia: Apache-2.0
• Lenguaje: Python 3.11+
• Estado: En vivo en producción con 134 pruebas aprobadas

Limitaciones y planes futuros

La herramienta no es un reemplazo completo para cron: las tareas temporales como resúmenes diarios y síntesis programadas aún necesitan cron. Maneja específicamente eventos reactivos que las herramientas pueden enviar mediante webhooks.

Las limitaciones actuales incluyen configuración manual y un proceso de incorporación rudimentario. El autor planea construir un validador de configuración "gateway doctor" y opciones de implementación más fáciles si la adopción crece.

Áreas para retroalimentación

El autor está buscando retroalimentación sobre:

• La interfaz del clasificador SOUL.md: si leer los primeros 500 caracteres tiene sentido o si una estrategia de contexto diferente sería mejor
• Alcance del prefiltro: si el control a nivel de repositorio/proyecto/rama es suficiente o si se necesita control a nivel de tipo de evento
• Fuentes de webhook adicionales: actualmente admite GitHub, Linear, PostHog; considerando Slack, Sentry, Jira a continuación

Notas de arquitectura: El autor es un PM, no un ingeniero de software, y construyó esto con Claude Code. El código es funcional y probado, pero puede tener patrones que desarrolladores experimentados de Python podrían mejorar.