Technical reference

API の使用量とコスト

このドキュメントでは、API キーを呼び出す可能性がある機能と、そのコストがどこに表示されるかを示します。対象は、プロバイダー使用量または有料 API 呼び出しを発生させる可能性がある OpenClaw 機能です。

コストが表示される場所（チャット + CLI）

セッションごとのコストスナップショット

/status は、現在のセッションモデル、コンテキスト使用量、最後の応答トークンを表示します。
OpenClaw が使用量メタデータとアクティブモデルのローカル価格を持っている場合、/status は最後の返信の推定コストも表示します。これには、Bedrock aws-sdk モデルのように、明示的に価格設定された API キー不要プロバイダーも含まれる場合があります。
ライブセッションメタデータが少ない場合、/status は最新のトランスクリプト使用量エントリからトークン/キャッシュカウンターとアクティブなランタイムモデルラベルを復元できます。既存のゼロ以外のライブ値は引き続き優先され、保存済み合計が欠落しているか小さい場合は、プロンプトサイズのトランスクリプト合計が優先されることがあります。

メッセージごとのコストフッター

/usage full は、アクティブモデルのローカル価格が設定され、使用量メタデータが利用可能な場合、推定コストを含む使用量フッターをすべての返信に追加します。
/usage tokens はトークンのみを表示します。サブスクリプション形式の OAuth/トークンおよび CLI フローでは、そのランタイムが互換性のある使用量メタデータを提供し、明示的なローカル価格が設定されていない限り、引き続きトークンのみが表示されます。
Gemini CLI 注記: デフォルトの stream-json 出力とレガシー JSON オーバーライドはいずれも stats から使用量を読み取り、stats.cached を cacheRead に正規化し、必要に応じて stats.input_tokens - stats.cached から入力トークンを導出します。

Anthropic 注記: Anthropic スタッフから、OpenClaw 形式の Claude CLI 使用が再び許可されたと伝えられたため、Anthropic が新しいポリシーを公開しない限り、OpenClaw はこの統合における Claude CLI の再利用と claude -p の使用を認可済みとして扱います。Anthropic は今も、OpenClaw が /usage full で表示できるメッセージごとのドル建て推定額を公開していません。

CLI 使用量ウィンドウ（プロバイダークォータ）

openclaw status --usage と openclaw channels list は、プロバイダーの使用量ウィンドウ（メッセージごとのコストではなくクォータスナップショット）を表示します。
人間向けの出力は、プロバイダー間で X% left に正規化されます。
現在の使用量ウィンドウプロバイダー: Anthropic、GitHub Copilot、Gemini CLI、OpenAI Codex、MiniMax、Xiaomi、z.ai。
MiniMax 注記: 生の usage_percent / usagePercent フィールドは残りクォータを意味するため、OpenClaw は表示前にそれらを反転します。カウントベースのフィールドが存在する場合は引き続き優先されます。プロバイダーが model_remains を返す場合、OpenClaw はチャットモデルのエントリを優先し、必要に応じてタイムスタンプからウィンドウラベルを導出し、プランラベルにモデル名を含めます。
これらのクォータウィンドウの使用量認証は、利用可能な場合はプロバイダー固有のフックから取得されます。それ以外の場合、OpenClaw は認証プロファイル、環境、または設定から一致する OAuth/API キー認証情報にフォールバックします。

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

キーの検出方法

OpenClaw は次の場所から認証情報を取得できます。

認証プロファイル（エージェントごと、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、memorySearch.*、talk.providers.*.apiKey）。
Skills（skills.entries.<name>.apiKey）。これはキーをスキルプロセスの環境にエクスポートする場合があります。

キーを消費する可能性がある機能

1) コアモデル応答（チャット + ツール）

すべての返信またはツール呼び出しは、現在のモデルプロバイダー（OpenAI、Anthropic など）を使用します。これは使用量とコストの主な発生源です。

これには、OpenClaw のローカル UI の外で課金されるサブスクリプション形式のホスト型プロバイダーも含まれます。たとえば、OpenAI Codex、Alibaba Cloud Model Studio Coding Plan、MiniMax Coding Plan、Z.AI / GLM Coding Plan、および Extra Usage が有効な Anthropic の OpenClaw Claude ログイン経路です。

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

2) メディア理解（音声/画像/動画）

受信メディアは、返信の実行前に要約/文字起こしされる場合があります。これはモデル/プロバイダー API を使用します。

音声: OpenAI / Groq / Deepgram / DeepInfra / Google / Mistral。
画像: OpenAI / OpenRouter / Anthropic / DeepInfra / Google / MiniMax / Moonshot / Qwen / Z.AI。
動画: Google / Qwen / Moonshot。

メディア理解を参照してください。

3) 画像および動画生成

共有生成機能もプロバイダーキーを消費する場合があります。

画像生成: OpenAI / Google / DeepInfra / fal / MiniMax
動画生成: DeepInfra / Qwen

画像生成は、agents.defaults.imageGenerationModel が未設定の場合、認証に裏付けられたデフォルトプロバイダーを推定できます。動画生成では現在、qwen/wan2.6-t2v などの明示的な agents.defaults.videoGenerationModel が必要です。

画像生成、Qwen Cloud、およびモデルを参照してください。

4) メモリエンベディング + セマンティック検索

セマンティックメモリ検索は、リモートプロバイダー向けに設定されている場合、エンベディング API を使用します。

memorySearch.provider = "openai" → OpenAI エンベディング
memorySearch.provider = "gemini" → Gemini エンベディング
memorySearch.provider = "voyage" → Voyage エンベディング
memorySearch.provider = "mistral" → Mistral エンベディング
memorySearch.provider = "deepinfra" → DeepInfra エンベディング
memorySearch.provider = "lmstudio" → LM Studio エンベディング（ローカル/セルフホスト）
memorySearch.provider = "ollama" → Ollama エンベディング（ローカル/セルフホスト。通常、ホスト型 API 課金なし）
ローカルエンベディングが失敗した場合のリモートプロバイダーへの任意のフォールバック

memorySearch.provider = "local" を使用するとローカルに保てます（API 使用なし）。

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

5) Web 検索ツール

web_search は、プロバイダーによっては使用料が発生する場合があります。

Brave Search API: BRAVE_API_KEY または plugins.entries.brave.config.webSearch.apiKey
Exa: EXA_API_KEY または plugins.entries.exa.config.webSearch.apiKey
Firecrawl: FIRECRAWL_API_KEY または plugins.entries.firecrawl.config.webSearch.apiKey
Gemini (Google Search): GEMINI_API_KEY または plugins.entries.google.config.webSearch.apiKey
Grok (xAI): xAI OAuth プロファイル、XAI_API_KEY、または plugins.entries.xai.config.webSearch.apiKey
Kimi (Moonshot): KIMI_API_KEY、MOONSHOT_API_KEY、または plugins.entries.moonshot.config.webSearch.apiKey
MiniMax Search: MINIMAX_CODE_PLAN_KEY、MINIMAX_CODING_API_KEY、MINIMAX_API_KEY、または plugins.entries.minimax.config.webSearch.apiKey
Ollama Web Search: 到達可能でサインイン済みのローカル Ollama ホストではキー不要。直接の https://ollama.com 検索は OLLAMA_API_KEY を使用し、認証で保護されたホストは通常の Ollama プロバイダーの bearer 認証を再利用できます
Perplexity Search API: PERPLEXITY_API_KEY、OPENROUTER_API_KEY、または plugins.entries.perplexity.config.webSearch.apiKey
Tavily: TAVILY_API_KEY または plugins.entries.tavily.config.webSearch.apiKey
DuckDuckGo: 明示的に選択された場合のキー不要プロバイダー（API 課金なし。ただし非公式で HTML ベース）
SearXNG: SEARXNG_BASE_URL または plugins.entries.searxng.config.webSearch.baseUrl（キー不要/セルフホスト。ホスト型 API 課金なし）

レガシーの tools.web.search.* プロバイダーパスは、引き続き一時的な互換性 shim を通じて読み込まれますが、推奨される設定サーフェスではなくなりました。

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

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

5) Web 取得ツール（Firecrawl）

web_fetch は、キー不要のスターターアクセスで Firecrawl を呼び出せます。より高い上限には API キーを追加してください。

FIRECRAWL_API_KEY または plugins.entries.firecrawl.config.webFetch.apiKey

Firecrawl が設定されていない場合、このツールは直接取得と同梱の web-readability Plugin にフォールバックします（有料 API なし）。ローカルの Readability 抽出をスキップするには、plugins.entries.web-readability.enabled を無効にします。

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

6) プロバイダー使用量スナップショット（ステータス/ヘルス）

一部のステータスコマンドは、クォータウィンドウまたは認証ヘルスを表示するためにプロバイダー使用量エンドポイントを呼び出します。これらは通常低頻度の呼び出しですが、それでもプロバイダー API に到達します。

openclaw status --usage
openclaw models status --json

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

7) Compaction セーフガード要約

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

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

8) モデルスキャン / プローブ

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

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

9) Talk（音声）

Talk モードは、設定されている場合に ElevenLabs を呼び出せます。

ELEVENLABS_API_KEY または talk.providers.elevenlabs.apiKey

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

10) Skills（サードパーティ API）

Skills は skills.entries.<name>.apiKey に apiKey を保存できます。スキルが外部 API にそのキーを使用する場合、そのスキルのプロバイダーに応じてコストが発生する可能性があります。

Skillsを参照してください。