Technical reference
API の使用量とコスト
このドキュメントでは、API キーを呼び出す可能性がある機能と、そのコストがどこに表示されるかを一覧します。プロバイダー使用量や有料 API 呼び出しを発生させる可能性がある OpenClaw 機能に焦点を当てています。
コストが表示される場所（チャット + CLI）
セッションごとのコストスナップショット
/statusは現在のセッションモデル、コンテキスト使用量、直近の応答トークンを表示します。- モデルが API キー認証を使用する場合、
/statusは直近の返信の推定コストも表示します。 - ライブセッションメタデータが少ない場合、
/statusは最新のトランスクリプト使用量エントリからトークン/キャッシュカウンターとアクティブなランタイムモデルラベルを復元できます。既存のゼロでないライブ値は引き続き優先され、保存済み合計が欠落しているか小さい場合は、プロンプトサイズのトランスクリプト合計が優先されることがあります。
メッセージごとのコストフッター
/usage fullはすべての返信に使用量フッターを追加し、推定コスト（API キーのみ）を含めます。/usage tokensはトークンのみを表示します。サブスクリプション形式の OAuth/トークンおよび CLI フローではドルコストを非表示にします。- Gemini CLI 注記: CLI が JSON 出力を返す場合、OpenClaw は
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 など）を使用します。これは使用量とコストの主な発生源です。
これには、OpenAI Codex、Alibaba Cloud Model Studio Coding Plan、MiniMax Coding Plan、Z.AI / GLM Coding Plan、および Extra Usage が有効な Anthropic の OpenClaw Claude ログイン経路など、OpenClaw のローカル UI 外で引き続き課金されるサブスクリプション形式のホステッドプロバイダーも含まれます。
価格設定についてはモデルを、表示についてはトークン使用量とコストを参照してください。
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_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 プロバイダーのベアラー認証を再利用できます。 - 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 は、API キーが存在する場合に Firecrawl を呼び出せます。
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 --usageopenclaw 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 を保存できます。Skill が外部 API にそのキーを使用する場合、Skill のプロバイダーに応じてコストが発生する可能性があります。
Skillsを参照してください。