Heartbeat-gateway: Событийная замена опросу cron в OpenClaw

Что делает heartbeat-gateway

Heartbeat-gateway — это событийная замена опроса heartbeat на основе cron в OpenClaw. Вместо опроса каждые 30 минут для проверки изменений, он получает вебхуки от внешних инструментов и обрабатывает их немедленно.

Ключевые детали из источника

Инструмент был создан для решения проблемы высоких затрат на API из-за опроса heartbeat по умолчанию в OpenClaw. При настройках по умолчанию опрос каждые 30 минут стоит примерно 86 долларов в месяц. Автор отмечает, что хотя OpenClaw добавил оптимизации lightContext и isolatedSession, они всё ещё используют опрос, а не событийную архитектуру.

Heartbeat-gateway работает следующим образом:

• Получает вебхуки от GitHub, Linear и PostHog
• Запускает бесплатный предварительный фильтр с ограничениями по репозиторию/проекту/ветке и списками всегда-исключаемых событий
• Классифицирует подходящие события относительно вашего SOUL.md с помощью лёгкого вызова LLM (~200 токенов)
• Записывает действия напрямую в HEARTBEAT.md для чтения вашим агентом

Улучшения производительности:

• Снижение затрат: ~4,50 долларов в месяц против ~86 долларов в месяц
• Улучшение задержки: менее 2 секунд против до 30 минут

Технические характеристики:

• Версия: v0.1.1
• Лицензия: Apache-2.0
• Язык: Python 3.11+
• Статус: Работает в продакшене с 134 пройденными тестами

Ограничения и планы на будущее

Инструмент не является полной заменой cron — временные задачи, такие как ежедневные дайджесты и запланированный синтез, всё ещё требуют cron. Он специально обрабатывает реактивные события, которые инструменты могут отправлять через вебхуки.

Текущие ограничения включают ручную настройку и сложный процесс адаптации. Автор планирует создать валидатор конфигурации "gateway doctor" и более простые варианты развёртывания, если инструмент получит распространение.

Области для обратной связи

Автор ищет обратную связь по:

• Интерфейсу классификатора SOUL.md — имеет ли смысл чтение первых 500 символов или нужна другая стратегия контекста
• Предварительной фильтрации — достаточно ли контроля на уровне репозитория/проекта/ветки или нужен контроль на уровне типа события
• Дополнительным источникам вебхуков — сейчас поддерживаются GitHub, Linear, PostHog; рассматриваются Slack, Sentry, Jira

Примечания по архитектуре: Автор — менеджер продукта, а не инженер-программист, и создал этот инструмент с помощью Claude Code. Код функционален и протестирован, но может содержать шаблоны, которые опытные разработчики Python могли бы улучшить.