vivekchand/clawmetry

See your agent think. Zero-config observability & governance for 30 AI agent runtimes: Claude Code, OpenAI Codex, Hermes, OpenClaw & 26 more. Live token costs, sessions, tool calls, crons.

ClawMetry の機能

ClawMetry は、AI コーディングエージェントが既に書き込むセッションログを監視するローカルダッシュボードです。読み取り専用のファイルを読み取ることで、すべてのツール呼び出し、トークン使用量、コストのタイムラインを構築し、エージェントが進捗しているのか、それとも永遠にループしているのかを一目で確認できます。

すぐに使える状態で動作します – Python パッケージをインストールして clawmetry を実行するだけです。プログラムは http://localhost:8900 で Web UI を起動し、マシン上の 33 のサポートされているエージェントランタイム (例: Claude Code、OpenAI Codex、Cursor、OpenClaw、NVIDIA NemoClaw など) を自動的に検出します。コードの変更、SDK のインポート、または計装は必要ありません。

主な機能

機能	表示内容	取得方法
セッションリプレイ	タイムスタンプ付きのターンバイターンのトランスクリプト、ツール呼び出し、モデル応答。	ランタイムのセッションファイルを読み取ります (読み取り専用)。
コストとトークンの内訳	エージェントごと、モデルごとの日次、週次、月次の支出。異常フラグ付き。	各ランタイムが公開するトークン数と価格データを解析します。
フロー図	メッセージが user → gateway → model → tools に移動する様子を示すライブグラフ。	同じセッションログから構築されます。追加のネットワークトラフィックはありません。
コンテキストウィンドウ使用量	各プロバイダーのコンテキストウィンドウのパーセント、コンパクションイベント、オーバーフロー警告。	プロバイダー固有のウィンドウサイズの組み込みテーブル (Anthropic、OpenAI、Google など) を使用します。
メモリ/スキルの読み込み	各エージェントが実際に読み込んだファイルと「スキル」。	ランタイムメタデータから抽出されます。
ヘルスとアラート	ディスク/メモリ使用量、レート制限ヒット、エラースパイク、予算上限。Slack、Discord、PagerDuty、Telegram、Email にプッシュ可能。	ローカルで監視されます。オプションのアウトバウンドウェブフック。
承認	リスクの高いツール呼び出し (例: sudo、シークレット露出) を一時停止し、スマートフォンから承認/拒否します。	オプションの強制プロキシが必要です。デフォルトではオフです。
SDK トラッキング	LangChain、Pydantic-AI などでエージェントを構築する場合、ClawMetry は LLM 呼び出しをコードに帰属させることができます。	有効にできるインターセプター (`CLAWMETRY_INTERCEPT=1`) を介して。

使用方法

インストール – pip install clawmetry (Python 3.8+)。
実行 – clawmetry はデーモンを起動し、UI を開きます。
探索 – ヘッダーでランタイムを切り替えることができます。各タブには上記のビューが表示されます。
(オプション) 接続 – clawmetry connect は暗号化されたスナップショットをクラウドにアップロードしてリモートビューを可能にします。それ以外はすべてマシンに残ります。

エージェントがまだない場合は、clawmetry --sample で 3 つの合成セッションが読み込まれ、UI を探索できます。

価格とライセンス

無料ティア – OpenClaw、NVIDIA NemoClaw、Goose、Qwen Code でローカルに動作します。データはボックスから出ません。
Starter ($9 / ノード / 月) – 他の 28 のランタイムとスナップショットのクラウド同期が追加されます。
Pro ($19 / ノード / 月) – 承認、ポリシーエンジン、異常検出、コスト最適化、OpenTelemetry エクスポート、改ざん防止監査ログなどが追加されます。

すべてのティアは MIT ライセンスのソースです。有料機能はクローズドソースのコンパニオン (clawmetry-pro) を介して提供されます。

データプライバシーとネットワークトラフィック

デフォルトでは、セッションコンテンツはどこにも送信されません。
唯一のアウトバウンド呼び出しは、匿名のインストール ping、PyPI バージョンチェック、バナーのための 1 回限りのパブリック IP ルックアップです。
どちらもオプトアウト可能で、docs/EGRESS.md に文書化されています。
clawmetry connect を明示的に実行すると、スナップショットはエンドツーエンドで暗号化されます。復号化は、整合性が検証された静的 JS ファイルを使用してブラウザで行われます。

パフォーマンスへの影響

計装ポイント	追加レイテンシ (標準)	デフォルト状態
セッションファイルの追跡	0 ms (別プロセス)	オン
HTTP インターセプター	LLM 呼び出しあたり +0.44 ms	オフ
プリツールフックゲート	ゲートされた呼び出しあたり +44 ms	オフ
強制プロキシ	LLM 呼び出しあたり +9.7 ms	オフ

デーモン自体は、CPU コアの約 12 % と、ディスク上で 100k イベントあたり約 70 KB を使用します。ベンチマークは benchmarks/overhead.py にあります。

誰が恩恵を受けるか?

複数のコーディングエージェントを実行する開発者 (例: CI サーバーまたは個人用ワークステーション上) で、行き詰まったループ、コスト超過、またはリスクの高いツールの使用を発見するための単一のペインが必要な場合。
予算上限を強制したり、危険なアクションに手動承認を要求したいチームリーダー。
コードを変更せずにさまざまなエージェントランタイムの動作を比較する研究者。

制限と注意事項

ダッシュボードは、各ランタイムが実際にログに記録するデータのみを表示できます。一部のランタイムはコスト情報を公開しないため、互換性マトリックスに反映されます。
コンテキストウィンドウのパーセンテージは、プロバイダー固有のウィンドウサイズに対して計算されます。ランタイムがテーブルエントリよりも大きいウィンドウを持つモデルを使用する場合、パーセンテージが誇張されて表示される可能性があります。
承認とポリシー強制には、オプションのプロキシコンポーネントが必要です。これはデフォルトではオフです。

C6. 無料ティアは 4 つのランタイムのみをサポートします。残りは有料プランまたは clawmetry-pro コンパニオンが必要です。

クイックスタートスニペット

pip install clawmetry               # パッケージをインストール
clawmetry                           # デーモンを起動して UI を開く
# エージェントがまだない場合:
clawmetry --sample                  # デモ用の合成セッションを読み込む

詳細情報

ドキュメント – docs/ には、互換性、コンテキストの吹き出し、オーバーヘッド、承認、OpenTelemetry エクスポート、独自のエージェントランタイムの追加方法に関する詳細なガイドが含まれています。
スクリーンショット – README には、コストの内訳、フロー図、アラート、品質グレードを示すスクリーンショットがいくつか含まれています。
価格 – 完全な価格表は https://clawmetry.com/pricing にあります。

ClawMetry は本質的に、AI コーディングエージェントの監視と可観測性レイヤーであり、エージェント自体に変更を加えることなく、可視性、コスト認識、安全性コントロールを提供します。