Heartbeat-gateway : Remplacement piloté par événements pour le sondage cron dans OpenClaw

Ce que fait heartbeat-gateway

Heartbeat-gateway est un remplacement événementiel pour la vérification périodique basée sur cron dans OpenClaw. Au lieu de vérifier toutes les 30 minutes pour voir si quelque chose a changé, il reçoit des webhooks d'outils externes et les traite immédiatement.

Détails clés de la source

L'outil a été construit pour résoudre les coûts élevés d'API de la vérification périodique par défaut d'OpenClaw. Avec les paramètres par défaut, vérifier toutes les 30 minutes coûte environ 86 $/mois. L'auteur note que bien qu'OpenClaw ait ajouté des optimisations lightContext et isolatedSession, celles-ci impliquent toujours une vérification périodique plutôt qu'une architecture événementielle.

Heartbeat-gateway fonctionne en :

• Recevant des webhooks de GitHub, Linear et PostHog
• Exécutant un pré-filtre à coût zéro avec un cadrage par dépôt/projet/branche et des listes d'exclusion systématique
• Classifiant les événements éligibles par rapport à votre SOUL.md avec un appel LLM léger (~200 tokens)
• Écrivant les éléments actionnables directement dans HEARTBEAT.md pour que votre agent les lise

Améliorations des performances :

• Réduction des coûts : ~4,50 $/mois contre ~86 $/mois
• Amélioration de la latence : moins de 2 secondes contre jusqu'à 30 minutes

Spécifications techniques :

• Version : v0.1.1
• Licence : Apache-2.0
• Langage : Python 3.11+
• Statut : En production avec 134 tests réussis

Limitations et projets futurs

L'outil n'est pas un remplacement complet de cron - les tâches temporelles comme les synthèses quotidiennes et les synthèses programmées nécessitent toujours cron. Il gère spécifiquement les événements réactifs que les outils peuvent envoyer via des webhooks.

Les limitations actuelles incluent une configuration manuelle et une intégration approximative. L'auteur prévoit de construire un validateur de configuration "gateway doctor" et des options de déploiement plus faciles si l'adoption augmente.

Domaines pour les retours

L'auteur recherche des retours sur :

• L'interface de classificateur SOUL.md - si la lecture des 500 premiers caractères a du sens ou si une stratégie de contexte différente serait meilleure
• Le cadrage du pré-filtre - si le contrôle au niveau dépôt/projet/branche est suffisant ou si un contrôle au niveau type d'événement est nécessaire
• Les sources de webhook supplémentaires - actuellement prend en charge GitHub, Linear, PostHog ; envisage Slack, Sentry, Jira ensuite

Notes d'architecture : L'auteur est un chef de produit, pas un ingénieur logiciel, et a construit cela avec Claude Code. Le code est fonctionnel et testé mais peut avoir des modèles que les développeurs Python expérimentés pourraient améliorer.