Heartbeat-gateway: OpenClaw에서 cron 폴링을 대체하는 이벤트 기반 솔루션

Heartbeat-gateway가 하는 일

Heartbeat-gateway는 OpenClaw의 cron 기반 하트비트 폴링을 대체하는 이벤트 기반 솔루션입니다. 30분마다 변경 사항을 확인하기 위해 폴링하는 대신, 외부 도구로부터 웹훅을 받아 즉시 처리합니다.

원본의 주요 내용

이 도구는 OpenClaw의 기본 하트비트 폴링으로 인한 높은 API 비용 문제를 해결하기 위해 만들어졌습니다. 기본 설정으로 30분마다 폴링하면 약 $86/월의 비용이 발생합니다. 저자는 OpenClaw가 lightContext와 isolatedSession 최적화를 추가했지만, 여전히 이벤트 기반 아키텍처가 아닌 폴링 방식을 사용한다고 지적합니다.

Heartbeat-gateway는 다음과 같이 작동합니다:

• GitHub, Linear, PostHog로부터 웹훅 수신
• 저장소/프로젝트/브랜치 범위 지정과 항상-제외 목록을 사용한 무비용 사전 필터 실행
• 경량 LLM 호출(~200 토큰)로 SOUL.md에 대해 적격 이벤트 분류
• 실행 가능 항목을 에이전트가 읽을 수 있도록 HEARTBEAT.md에 직접 기록

성능 개선:

• 비용 절감: 약 $4.50/월 대 약 $86/월
• 지연 시간 개선: 2초 미만 대 최대 30분

기술 사양:

• 버전: v0.1.1
• 라이선스: Apache-2.0
• 언어: Python 3.11+
• 상태: 134개 테스트 통과, 프로덕션 환경에서 운영 중

제한 사항과 향후 계획

이 도구는 cron을 완전히 대체하는 것은 아닙니다. 일일 요약과 예약된 통합 같은 시간 기반 작업은 여전히 cron이 필요합니다. 이 도구는 도구들이 웹훅을 통해 푸시할 수 있는 반응형 이벤트를 특별히 처리합니다.

현재 제한 사항으로는 수동 설정과 다소 불편한 온보딩 과정이 있습니다. 저자는 채택이 늘어나면 "게이트웨이 닥터" 설정 검증 도구와 더 쉬운 배포 옵션을 구축할 계획입니다.

피드백 요청 사항

저자는 다음과 같은 사항에 대한 피드백을 구하고 있습니다:

• SOUL.md 분류기 인터페이스 - 처음 500자를 읽는 것이 합리적인지, 아니면 다른 컨텍스트 전략이 더 나을지
• 사전 필터 범위 지정 - 저장소/프로젝트/브랜치 수준 제어가 충분한지, 아니면 이벤트 유형 수준 제어가 필요한지
• 추가 웹훅 소스 - 현재 GitHub, Linear, PostHog 지원; 다음으로 Slack, Sentry, Jira 고려 중

아키텍처 노트: 저자는 소프트웨어 엔지니어가 아닌 PM이며, Claude Code로 이 도구를 구축했습니다. 코드는 기능적이고 테스트되었지만, 경험 많은 Python 개발자들이 개선할 수 있는 패턴이 있을 수 있습니다.