コストが表示される場所
/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から入力トークンを導出します。
- 選択した日付範囲について、トランスクリプトから導出したトークン合計と推定コスト合計を表示し、プロバイダー、モデル、エージェント、チャンネル、トークン種別ごとの内訳も示します。
- 選択範囲の終了日に終わる、より短いカレンダーウィンドウを比較します。欠落した日付は使用量ゼロのカレンダー日として数えられ、密度の高いウィンドウを作るためにスキップされることはありません。
- 日次チャートのスケールを直接ラベル表示します。
√バッジは、平方根圧縮によって使用量の少ない日も見える状態に保たれていることを意味します。 - これらの合計は、利用可能なローカルセッション履歴を説明するものであり、プロバイダーの請求書や通算の課金台帳ではありません。価格がないエントリがある場合、UI は警告します。
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 キー認証情報にフォールバックします。
Anthropic は、新しいポリシーを公開しない限り、Claude CLI の再利用（
claude -p を含む）が認可された統合パターンであることを確認しています。Anthropic はメッセージ単位の金額見積もりを公開していないため、/usage full は Claude CLI 使用量のコストを表示できません。キーの検出方法
- 認証プロファイル: エージェント単位で、
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 を読み取ります。
| プロバイダー | 環境変数 |
|---|---|
| Brave Search | BRAVE_API_KEY |
| DuckDuckGo | キー不要。非公式、HTML ベース、課金なし |
| Exa | EXA_API_KEY |
| Firecrawl | FIRECRAWL_API_KEY |
| Gemini（Google Search） | GEMINI_API_KEY |
| Grok（xAI） | xAI OAuth プロファイルまたは XAI_API_KEY |
| Kimi（Moonshot） | KIMI_API_KEY または MOONSHOT_API_KEY |
| MiniMax Search | MINIMAX_CODE_PLAN_KEY、MINIMAX_CODING_API_KEY、MINIMAX_OAUTH_TOKEN、または MINIMAX_API_KEY |
| Ollama Web Search | 到達可能なサインイン済みローカルホストではキー不要。直接の https://ollama.com 検索は OLLAMA_API_KEY を使用します。認証で保護されたホストは通常の Ollama プロバイダーのベアラー認証を再利用します |
| Parallel | PARALLEL_API_KEY |
| Perplexity Search API | PERPLEXITY_API_KEY または OPENROUTER_API_KEY |
| SearXNG | SEARXNG_BASE_URL。キー不要/セルフホスト型、ホスト型課金なし |
| Tavily | TAVILY_API_KEY |
tools.web.search.* 設定パスは互換性シムを通じて引き続き読み込まれますが、推奨されるサーフェスではなくなりました。
Brave Search の無料クレジット: 各プランには毎月更新される 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を参照してください。
Talk（音声）
Talk モードは、設定されている場合に ElevenLabs を呼び出せます:ELEVENLABS_API_KEY または talk.providers.elevenlabs.apiKey。
Talk モードを参照してください。
Skills（サードパーティ API）
Skills はskills.entries.<name>.apiKey に apiKey を保存できます。Skills がそのキーを外部 API に対して使用する場合、コストは Skills のプロバイダーに従います。
Skillsを参照してください。