API の使用量とコスト

OpenClaw の機能のうち、有料プロバイダー API を呼び出す可能性があるもの、各機能が認証情報を読み取る場所、および発生したコストが表示される場所の一覧です。

コストが表示される場所

/status（セッション単位のスナップショット）

• 現在のセッションのモデル、コンテキスト使用量、直前の応答のトークン数を表示します。
• OpenClaw が使用量メタデータとアクティブなモデルのローカル価格情報を取得できる場合、直前の応答の推定コストを追加します。これには、Bedrock の aws-sdk モデルなど、API キーを使用しないものの価格が明示的に設定されたプロバイダーも含まれます。
• ライブセッションのスナップショットに十分な情報がない場合、/status は最新のトランスクリプト使用量エントリからトークン数、キャッシュ数、およびアクティブなモデルのラベルを復元します。既存のライブ値がゼロでなければ、トランスクリプトのデータより優先されます。保存済みの合計がない場合や、トランスクリプト内のプロンプト相当の合計より小さい場合は、そのトランスクリプトの合計が優先されることがあります。

/usage（メッセージ単位のフッター）

• /usage full はすべての応答に使用量フッターを追加します。ローカル価格が設定され、使用量メタデータが利用可能な場合は、推定コストも含まれます。
• /usage tokens はトークン数のみを表示します。サブスクリプション形式の OAuth／トークンおよび CLI ランタイムでは、互換性のある使用量メタデータと明示的なローカル価格の両方が提供されない限り、トークン数のみが表示されます。
• /usage cost はローカルのコスト概要を出力し、/usage off はフッターを無効にします。
• Gemini CLI に関する注記：stream-json と従来の json の両方で、使用量は stats に含まれます。OpenClaw は stats.cached を cacheRead に正規化し、必要に応じて stats.input_tokens - stats.cached から入力トークン数を算出します。

Control UI → 使用量（セッション横断分析）

• 選択した日付範囲について、トランスクリプトから算出したトークン合計と推定コスト合計を、プロバイダー、モデル、エージェント、チャンネル、トークン種別ごとの内訳とともに表示します。
• 選択範囲の終了日までの、より短い暦上の期間と比較します。データがない日付は使用量ゼロの暦日として数えられ、密度の高い期間を作るために除外されることはありません。
• 日次グラフの目盛りを直接表示します。√ バッジは、平方根圧縮によって使用量の少ない日も見えるようにしていることを示します。
• これらの合計は、利用可能なローカルセッション履歴を表すものであり、プロバイダーの請求書や全期間の請求台帳ではありません。一部のエントリに価格情報がない場合、UI に警告が表示されます。

CLI の使用量ウィンドウ（メッセージ単位のコストではなく、プロバイダーのクォータ）

• openclaw status --usage と openclaw channels list は、プロバイダーの使用量ウィンドウを X% left の形式で表示します。
• 現在、使用量ウィンドウに対応するプロバイダーは、Anthropic、ClawRouter、DeepSeek、GitHub Copilot、Gemini CLI、MiniMax、OpenAI（ChatGPT／Codex の OAuth／トークン認証を含む）、Xiaomi、z.ai です。プロバイダーとフラグの完全な一覧については、モデル CLIおよびチャンネル CLIを参照してください。
• MiniMax の未加工の usage_percent／usagePercent フィールドは残りクォータを示すため、OpenClaw は値を反転します。件数ベースのフィールドがある場合は、そちらが優先されます。応答に model_remains 配列が含まれる場合、OpenClaw はチャットモデルのエントリを選択し、必要に応じてタイムスタンプからウィンドウラベルを算出し、プランラベルにモデル名を含めます。
• 使用量の認証情報は、利用可能な場合はプロバイダー固有のフックから取得されます。それ以外の場合、OpenClaw は認証プロファイル、環境変数、または設定から一致する OAuth／API キー認証情報を探します。

詳細な例については、トークン使用量とコストを参照してください。

キーの検出方法

• 認証プロファイル：エージェント単位で auth-profiles.json に保存されます。
• 環境変数：例として OPENAI_API_KEY、BRAVE_API_KEY、FIRECRAWL_API_KEY。
• 設定：models.providers.*.apiKey、plugins.entries.*.config.webSearch.apiKey、plugins.entries.firecrawl.config.webFetch.apiKey、agents.defaults.memorySearch.*、talk.providers.*.apiKey。
• Skills：skills.entries.<name>.apiKey。キーが Skills のプロセス環境にエクスポートされる場合があります。

キーを使用してコストが発生する可能性がある機能

コアモデルの応答（チャット＋ツール）

すべての応答またはツール呼び出しは、現在のモデルプロバイダー上で実行されます。これは使用量とコストの主な発生源です。OpenClaw のローカル UI の外部で請求されるサブスクリプション形式のホスト型プランも含まれます。対象には OpenAI Codex、Alibaba Cloud Model Studio Coding Plan、MiniMax Coding Plan、Z.AI／GLM Coding Plan、および Extra Usage が有効な Anthropic の Claude ログイン経路があります。

価格設定についてはモデル、表示についてはトークン使用量とコストを参照してください。

メディア理解（音声／画像／動画）

受信したメディアは、応答パイプラインの実行前にプロバイダー API を介して要約または文字起こしされることがあります。プロバイダー対応は Plugin ごとに登録され、Plugin の追加に伴って変わります。現在の一覧と設定については、メディア理解を参照してください。

画像および動画の生成

image_generate と video_generate は、利用可能な設定済みプロバイダーに処理を振り分けます。agents.defaults.imageGenerationModel が未設定の場合、画像生成では認証情報に基づいてデフォルトのプロバイダーを推定できます。動画生成には agents.defaults.videoGenerationModel の明示的な設定が必要です（例：qwen/wan2.6-t2v）。

現在のプロバイダー一覧については、画像生成および動画生成を参照してください。

メモリ埋め込みとセマンティック検索

agents.defaults.memorySearch.provider にリモートアダプター（例：openai、gemini、voyage、mistral、deepinfra、github-copilot、amazon-bedrock）を指定すると、セマンティックメモリ検索は埋め込み API を使用します。memorySearch.provider = "lmstudio" または "ollama" はローカル／セルフホスト型サーバーに対して実行され、通常はホスト型サービスの請求は発生しません。memorySearch.provider = "local" はすべての処理をデバイス上に保持し、API を使用しません。任意の memorySearch.fallback プロバイダーを指定すると、ローカル埋め込みの失敗を補うことができます。

メモリを参照してください。

Web 検索ツール

web_search では、選択したプロバイダーに応じて使用料金が発生することがあります。各プロバイダーは、最初に環境変数からキーを読み取り、次に plugins.entries.<id>.config.webSearch.apiKey から読み取ります。

従来の tools.web.search.* 設定パスも互換性シムを介して引き続き読み込まれますが、現在は推奨される設定方法ではありません。

Brave Search の無料クレジット：各プランには毎月更新される 5 ドル分の無料クレジットが含まれます。Search プランは 1,000 リクエストあたり 5 ドルのため、このクレジットにより毎月 1,000 リクエストまで無料で利用できます。予期しない料金を避けるため、Brave ダッシュボードで使用量上限を設定してください。

Web ツールを参照してください。

Web 取得ツール（Firecrawl）

web_fetch は、キーなしのスターターアクセスで Firecrawl を呼び出せます。上限を引き上げるには、FIRECRAWL_API_KEY（または plugins.entries.firecrawl.config.webFetch.apiKey）を追加します。Firecrawl が設定されていない場合、ツールは直接取得と同梱の web-readability Plugin にフォールバックします（有料 API は使用しません）。ローカルの Readability 抽出を省略するには、plugins.entries.web-readability.enabled を無効にします。

Web ツールを参照してください。

プロバイダー使用量のスナップショット（状態／稼働状況）

openclaw status --usage と openclaw models status --json は、プロバイダーの使用量エンドポイントを呼び出して、クォータウィンドウまたは認証状態を表示します。呼び出し頻度は低いものの、プロバイダー API へのアクセスは発生します。

モデル CLIを参照してください。

Compaction セーフガードによる要約

Compaction セーフガードは、現在のモデルを使用してセッション履歴を要約することがあり、実行時にプロバイダー API を呼び出します。

セッション管理と Compactionを参照してください。

モデルのスキャン／プローブ

openclaw models scan は OpenRouter モデルをプローブでき、プローブが有効な場合は OPENROUTER_API_KEY を使用します。

モデル CLIを参照してください。

トーク（音声）

トークモードは、設定されている場合に ElevenLabs を呼び出せます：ELEVENLABS_API_KEY または talk.providers.elevenlabs.apiKey。

トークモードを参照してください。

Skills（サードパーティ API）

Skills は skills.entries.<name>.apiKey に apiKey を保存できます。Skills がそのキーを外部 API に使用する場合、コストはその Skills のプロバイダーに従います。

Skillsを参照してください。

関連項目

• トークン使用量とコスト
• プロンプトキャッシュ
• 使用量の追跡