OpenClaw でトークンとコストを賢く管理する方法

AI ツールを使い続けていると、いつの間にかトークン消費が膨らみ、API の請求額を見て驚くことがあります。また、コンテキストウィンドウがいっぱいになり、モデルが重要な指示を忘れてしまうのも開発者にとって共通の悩みです。

OpenClaw では、これらのトークン使用量とコストを透明化し、効率的にコントロールする仕組みが備わっています。どのように管理すれば最適なかたちで運用できるか、具体的な方法を見ていきましょう。

必要なもの

OpenClaw の実行環境
API key（コスト表示を有効にする場合。OAuth の場合はトークン数のみ表示されます）

クイックスタート

5 分でトークン管理を始めるための手順です。

現在の状態を確認する: チャットで /status と入力してください。現在のセッションのモデル、コンテキスト使用量、前回のレスポンスのコスト見積もりが表示されます。
フッター表示を有効にする: /usage tokens または /usage full を入力すると、毎回の返信の末尾に使用量が表示されるようになります。
詳細な内訳を見る: /context list または /context detail を使うと、注入されたファイルやツールがどれだけコンテキストを占有しているか分かります。
コスト設定を追加する: 設定ファイルの models.providers.<provider>.models[].cost に、100万トークンあたりの単価（USD）を記述すると、金額が表示されるようになります。

トークン消費の内訳を知る

OpenClaw は文字数ではなく、モデル固有の tokens で計算します。英語の場合、1トークンはおおよそ4文字に相当します。

システムプロンプトの構成

OpenClaw は実行ごとにシステムプロンプトを組み立てます。これには以下の内容が含まれます：

Tool リストと短い説明
Skills リスト（メタデータのみ）
自己更新の手順
ワークスペースのファイル（AGENTS.md, SOUL.md など。大きなファイルは bootstrapMaxChars により 20,000 文字で切り詰められます）
現在時刻（UTC およびユーザーのタイムゾーン）
Runtime メタデータ（ホスト、OS、モデル情報）

コンテキストウィンドウに含まれるもの

モデルに送信される以下の要素すべてが、コンテキスト制限の対象となります：

上記のシステムプロンプト
会話履歴（ユーザーとアシスタントのメッセージ）
Tool の呼び出し結果
添付ファイルやトランスクリプト（画像、音声など）
要約（Compaction）やプルーニングのアーティファクト
プロバイダーによるセーフティヘッダー（不可視ですがカウントされます）

キャッシュと Heartbeat の活用

Anthropic などの API では、プロンプトキャッシュを利用することでコストを抑えられます。OpenClaw にはキャッシュを「温かい（Warm）」状態に保つ機能があります。

例えば、キャッシュの TTL（有効期限）が 1 時間の場合、Heartbeat を 55 分おきに設定することで、フルプロンプトの再キャッシュによる課金を避けることができます。

agents:
  defaults:
    model:
      primary: "anthropic/claude-opus-4-6"
    models:
      "anthropic/claude-opus-4-6":
        params:
          cacheRetention: "long"
    heartbeat:
      every: "55m"

また、Gateway 設定で cache-ttl pruning を有効にすると、キャッシュが切れたタイミングでセッションを整理し、再度効率的にキャッシュを構築できるようになります。

トークンを節約するためのヒント

/compact を使う: 会話が長くなってきたら、セッションを要約してコンテキストを解放しましょう。
Tool の出力を絞る: ワークフロー内で大きなデータを出力する場合は、必要な部分だけにトリミングしてください。
Skill の説明を簡潔にする: Skill リストは常にプロンプトに注入されるため、説明文を短く保つのが効果的です。
モデルを使い分ける: 試行錯誤の段階や、言葉数の多い作業には、より安価で小さなモデルを選択してください。

トラブルシューティング

コストが USD で表示されない: OAuth 認証を使用している場合、セキュリティ上の制約によりトークン数のみが表示されます。金額を表示するには API key を使用し、設定ファイルに価格情報を入力してください。
大きなファイルの内容が読み込まれない: agents.defaults.bootstrapMaxChars のデフォルト設定（20,000 文字）によって制限されている可能性があります。必要に応じてこの値を調整してください。

設定や最適化についてさらに詳しく知りたい場合は、AI Setup Assistant に質問してください。

次のステップ

OpenClaw Expert

まだ解決しませんか？

このページで解決しない場合は、OpenClaw Expertに直接質問してください。