Heartbeat-gateway: Substituição orientada a eventos para a sondagem cron no OpenClaw

O que o heartbeat-gateway faz

Heartbeat-gateway é uma substituição orientada a eventos para a verificação periódica baseada em cron no OpenClaw. Em vez de verificar a cada 30 minutos para ver se algo mudou, ele recebe webhooks de ferramentas externas e os processa imediatamente.

Detalhes importantes da fonte

A ferramenta foi criada para resolver os altos custos de API da verificação periódica padrão do OpenClaw. Nas configurações padrão, verificar a cada 30 minutos custa aproximadamente US$ 86/mês. O autor observa que, embora o OpenClaw tenha adicionado otimizações lightContext e isolatedSession, essas ainda envolvem verificação periódica em vez de uma arquitetura orientada a eventos.

O heartbeat-gateway funciona:

• Recebendo webhooks do GitHub, Linear e PostHog
• Executando um pré-filtro de custo zero com escopo de repositório/projeto/ramificação e listas de descarte automático
• Classificando eventos qualificados em relação ao seu SOUL.md com uma chamada leve de LLM (~200 tokens)
• Escrevendo itens acionáveis diretamente no HEARTBEAT.md para seu agente ler

Melhorias de desempenho:

• Redução de custo: ~US$ 4,50/mês vs ~US$ 86/mês
• Melhoria de latência: menos de 2 segundos vs até 30 minutos

Especificações técnicas:

• Versão: v0.1.1
• Licença: Apache-2.0
• Linguagem: Python 3.11+
• Status: Em produção com 134 testes passando

Limitações e planos futuros

A ferramenta não é uma substituição completa para o cron - tarefas temporais como resumos diários e sínteses agendadas ainda precisam do cron. Ela lida especificamente com eventos reativos que as ferramentas podem enviar via webhooks.

As limitações atuais incluem configuração manual e integração básica. O autor planeja criar um validador de configuração "gateway doctor" e opções de implantação mais fáceis se a adoção aumentar.

Áreas para feedback

O autor está buscando feedback sobre:

• A interface do classificador SOUL.md - se ler os primeiros 500 caracteres faz sentido ou se uma estratégia de contexto diferente seria melhor
• Escopo do pré-filtro - se o controle em nível de repositório/projeto/ramificação é suficiente ou se é necessário controle em nível de tipo de evento
• Fontes adicionais de webhook - atualmente suporta GitHub, Linear, PostHog; considerando Slack, Sentry, Jira em seguida

Notas de arquitetura: O autor é um gerente de produto, não um engenheiro de software, e construiu isso com Claude Code. O código é funcional e testado, mas pode ter padrões que desenvolvedores Python experientes poderiam melhorar.