ハートビートゲートウェイ：OpenClawにおけるcronポーリングのイベント駆動型代替

heartbeat-gatewayの機能

Heartbeat-gatewayは、OpenClawにおけるcronベースのハートビートポーリングをイベント駆動型に置き換えるツールです。30分ごとに変更を確認するポーリングの代わりに、外部ツールからのWebhookを受信し、即座に処理します。

ソースからの主要な詳細

このツールは、OpenClawのデフォルトハートビートポーリングによる高いAPIコストに対処するために構築されました。デフォルト設定では、30分ごとのポーリングで約86ドル/月のコストがかかります。著者は、OpenClawがlightContextやisolatedSessionの最適化を追加したものの、これらは依然としてポーリングを伴い、イベント駆動型アーキテクチャではないと指摘しています。

Heartbeat-gatewayの動作は以下の通りです：

• GitHub、Linear、PostHogからのWebhookを受信
• リポジトリ/プロジェクト/ブランチのスコープ指定と常時ドロップリストによるゼロコストの事前フィルターを実行
• 軽量なLLM呼び出し（約200トークン）で、SOUL.mdに対して適格なイベントを分類
• 実行可能な項目を直接HEARTBEAT.mdに書き込み、エージェントが読み取れるようにする

パフォーマンスの改善：

• コスト削減：約4.50ドル/月 vs 約86ドル/月
• レイテンシー改善：2秒未満 vs 最大30分

技術仕様：

• バージョン：v0.1.1
• ライセンス：Apache-2.0
• 言語：Python 3.11+
• ステータス：本番環境で稼働中、134件のテスト合格

制限事項と将来の計画

このツールはcronの完全な代替ではなく、日次ダイジェストやスケジュールされた合成などの時間的タスクには依然としてcronが必要です。ツールがWebhook経由でプッシュできる反応型イベントを特に処理します。

現在の制限事項には、手動セットアップと大まかなオンボーディングが含まれます。著者は、採用が増えた場合に「ゲートウェイドクター」設定バリデータとより簡単なデプロイオプションを構築する計画です。

フィードバックを求める領域

著者は以下の点についてフィードバックを求めています：

• SOUL.md分類器インターフェース - 最初の500文字を読むことが理にかなっているか、または異なるコンテキスト戦略がより良いか
• 事前フィルターのスコープ指定 - リポジトリ/プロジェクト/ブランチレベルの制御で十分か、またはイベントタイプレベルの制御が必要か
• 追加のWebhookソース - 現在はGitHub、Linear、PostHogをサポート；次にSlack、Sentry、Jiraを検討中

アーキテクチャに関する注記：著者はソフトウェアエンジニアではなくPMであり、Claude Codeを使用してこれを構築しました。コードは機能しテストされていますが、経験豊富なPython開発者が改善できるパターンがある可能性があります。