claw-tsaver

OpenClawユーザー向けのトークン節約MCPプロキシ。遅延展開（lazy expansion）により、ツール呼び出しのペイロードを90%以上削減します。

なぜ必要なのか

MCPのツール呼び出しは、1回のレスポンスで数千トークンものHTMLやJSONを返すことがよくありますが、モデルが実際に使用するのはそのうちの5%程度です。残りの95%はコンテキストウィンドウを無駄に消費し、コストを増大させます。claw-tsaverはOpenClawとダウンストリームのMCPサーバーの間に配置され、過大なレスポンスをインターセプトして、モデルにはコンパクトなプレビューとオンデマンドのハンドルを提供します。

Related MCP server: TokenSaver MCP

仕組み

sequenceDiagram
    participant U as OpenClaw (Claude)
    participant C as claw-tsaver proxy
    participant F as fetch / puppeteer / etc.
    U->>C: call_tool("fetch", url)
    C->>F: forward call
    F-->>C: 11,507 tokens of HTML
    Note over C: tiktoken count > threshold
    C->>C: store full content in SQLite
    C-->>U: {preview_head, preview_tail, expand_handle}<br/>(only 104 tokens)
    Note over U: model decides if it needs full text
    U->>C: expand_content(handle)
    C-->>U: full 11,507 tokens

実測値

OpenClaw + Claude Sonnet 4.6 + mcp-server-fetchにて検証（2026年4月25日）。 生データ: benchmarks/mvp-day1-fetch.jsonl。

クイックスタート

1. 前提条件

uvをインストールしてください（初回のみ設定）:

curl -LsSf https://astral.sh/uv/install.sh | sh

claw-tsaverのインストールは不要です。uvxがオンデマンドで取得して実行します。

2. ダウンストリームMCPサーバーの設定

~/.claw-tsaver/config.jsonを編集します（claw-tsaver-mcpを初回実行するとテンプレートが自動作成されます）:

{
  "downstream_servers": [
    {"name": "fetch", "command": "uvx", "args": ["mcp-server-fetch"]}
  ],
  "compression_threshold_tokens": 500
}

3. OpenClawへの登録

~/.openclaw/openclaw.jsonのトップレベルに以下のブロックを追加します:

"mcp": {
  "servers": {
    "claw-tsaver": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Yang1Bai/claw-tsaver",
               "claw-tsaver-mcp"]
    }
  }
}

その後、OpenClawゲートウェイを再起動します: openclaw gateway restart

ダッシュボード

オプション：リアルタイムのトークン節約統計を表示するローカルWeb UI。

uvx --from git+https://github.com/Yang1Bai/claw-tsaver claw-tsaver-dashboard

ブラウザで http://localhost:7878 を開いてください。

ロードマップ

• [x] モジュールA: 遅延展開プロキシ（今回のリリース）

• [x] モジュールD: ローカルダッシュボード（今回のリリース）

• [ ] モジュールB: ツールルーティング（ターンごとに必要なMCPのみを自動ロード）

• [ ] モジュールC: 会話履歴の圧縮（アトミックな事実カード）

ライセンス

MIT — LICENSEファイルを参照してください。

コントリビューション

IssueやPRを歓迎します。