OpenClawコンテキストメータープラグインは、Telegramトークンの使用率を表示します。

機能

openclaw-context-meterプラグインは、Telegramボットの応答ごとに自動的にトークン使用率を表示します。各応答の後に、📊 45k / 200k (22%)のような小さなフッターを送信します。圧縮が発生した場合（トークンが大幅に減少）、📊 30k / 200k (15%) — 150kから圧縮と表示します。

解決する問題

以前は、/statusを常に入力しなければ、コンテキストウィンドウがどれだけ埋まっているかを簡単に確認する方法がありませんでした。このプラグインは、トークン消費の自動的な可視化を提供します。

開発の経緯

v1 — OOM災害: 最初はexecSync("openclaw models list --json")を使用して、モデルのコンテキストウィンドウを動的に検出していました。これにより、プラグインが読み込まれるたびに完全なOpenClawプロセス（約2GB RAM）が起動しました。プラグインが起動時に4〜5回読み込まれる（エージェント/ランタイムごとに1回）と、これが原因で：2GBゲートウェイ + 5 × 2GBサブプロセス = 12GB → 即時OOMが発生しました。OOMキラーがsshdとNetworkManagerを終了させ、サーバーが完全に到達不能になり、無限再起動ループが発生しました。

v2 — 軽量修正: 40以上のモデルのコンテキストウィンドウをハードコードしました。サブプロセスなし、メモリオーバーヘッドゼロ。重要な気づき：OpenClawプラグインではexecSyncを使用しないこと。単純なCLIクエリでも、すべてのプラグインとTypeScriptコンパイルを含むランタイム全体が起動してしまうためです。

フォークが不要な理由

このプラグインは当初、before_compaction/after_compactionフックをパッチするためにOpenClawをフォークしていましたが、上流の変更によりこれが不要になりました：

• v2026.3.13+ — 上流で圧縮フックのコンテキストにsessionId + agentId + sessionKeyが渡されるようになりました
• v2026.3.22+ — 組み込みの🧹 コンテキストを圧縮中...通知（issue #38805）により、彼らの圧縮コードが不要になりました
• v2026.3.22+ — 基本的なトークン表示のための組み込み/usage tokens|full|costコマンド

プラグインは現在、まだ不足しているものに焦点を当てています：コンテキストウィンドウの割合表示。

特徴

• ゼロコスト — agent_end + message_sentフックのみを使用し、追加のAPI呼び出しなし
• サブプロセスなし — モデルのコンテキストウィンドウはハードコードされています（execSyncによるOOMリスクなし）
• スマートフィルタリング — tool_useターンをスキップし、最終的なテキスト応答後にのみフッターを送信
• デバウンス — 最後のメッセージから1.5秒待機し、ストリーム中のフッターを回避
• マルチエージェント — 複数のエージェントとTelegramアカウントで動作
• 圧縮検出 — トークンの減少を検出し、前後の統計を表示

既知の制限

• 一部のプロバイダー（Qwenなど）はtotalTokens: 0を返します — これらのモデルではフッターが表示されません
• ハードコードされたコンテキストウィンドウが新しいモデルでは間違っている可能性があります — v2026.3.22のソースから取得
• 現在はTelegramのみ（Bot API経由でフッターを送信）

インストール

cd ~/.openclaw/extensions
npm pack openclaw-context-meter
tar xzf openclaw-context-meter-*.tgz
mv package context-meter
rm openclaw-context-meter-*.tgz

openclaw.jsonに追加：

{
  "plugins": {
    "allow": ["context-meter"],
    "entries": {
      "context-meter": {
        "enabled": true
      }
    }
  }
}

OpenClaw >= 2026.3.22が必要です。