使用状況の追跡

​

概要

• 各プロバイダーの使用量エンドポイントから、プロバイダーの使用量／クォータを直接取得します。プロバイダーの推定請求額ではなく、プロバイダーが報告したプラン名、クォータ期間、残高、支出額、予算、日別コスト履歴、トークン／モデルの内訳、またはアカウント状態の概要のみを使用します。
• 人が読めるクォータ期間の出力は、プロバイダーが消費済みクォータ、残りクォータ、または生のカウントのみを報告する場合でも、X% left に正規化されます。リセット可能なクォータ期間がないプロバイダーでは、代わりにプロバイダーの概要テキスト（残高など）が表示されます。
• セッションレベルの /status と session_status ツールは、ライブセッションのスナップショットにトークン／モデルデータがない場合、セッションのトランスクリプトログにフォールバックします。このフォールバックは、不足しているトークン／キャッシュカウンターを補完し、アクティブなランタイムモデルのラベルを復元できるほか、セッションメタデータが欠落しているか、より小さい場合（totalTokensFresh !== true、ゼロ、またはトランスクリプトから導出された値未満）、プロンプト指向のより大きい合計値を優先します。ゼロ以外のライブ値は常にフォールバックより優先されます。

​

表示場所

• チャット内の /status：セッショントークンと推定コストを示すステータスカード（API キーモデルのみ）。利用可能な場合は、現在のモデルプロバイダーのプロバイダー使用量が、正規化された X% left 期間またはプロバイダーの概要テキストとして表示されます。
• チャット内の /usage off|tokens|full：応答ごとの使用量フッター。
• チャット内の /usage cost：OpenClaw セッションログから集計されたローカルコストの概要。
• CLI：openclaw status --usage は、プロバイダーごとの使用量／クォータの完全な内訳を出力します。
• CLI：openclaw models status は OAuth／トークン認証プロファイルを一覧表示し、使用量期間がある各プロバイダーの横にその概要を表示します。
• Control UI：使用量には、OpenClaw のセッションから導出されたトークンおよび推定コスト分析の上に、プロバイダーのプランと請求カードが表示されます。Anthropic および OpenAI Admin API の認証情報を追加すると、プロバイダーが報告した本日、7 日間、30 日間の支出額、日別トレンド、トークン合計、上位モデル、コストカテゴリも表示されます。
• Control UI：チャットコンポーザーのコンテキストリングのポップオーバーには、サブスクリプションプロバイダーのプラン使用量が表示されます。期間ごとのバー（5 時間、週間、モデル単位）、リセット時刻、判明している場合はプロバイダーのプラン（Max (20x) など）、追加使用量クレジットが含まれます。プランを通じて請求されるセッションでは、トークン単位の金額見積もりが非表示になります。API 請求のセッションでは、Est. cost と種類別コストの内訳が維持されます。Claude Code CLI（claude-cli）のセットアップでは、同じ Anthropic サブスクリプション使用量が再利用されます。
• macOS メニューバー：プロバイダー使用量のスナップショットが利用可能な場合、コンテキストの下にルートの「使用量」セクションが表示されます。メニューバーを参照してください。

​

Anthropic と OpenAI のコスト履歴

• Anthropic のサブスクリプション／セットアップ認証情報では、引き続き Claude のクォータ期間と、任意の追加使用量予算が表示されます。代わりに組織の Usage and Cost API 履歴を表示するには、ANTHROPIC_ADMIN_KEY または ANTHROPIC_ADMIN_API_KEY を設定します。sk-ant-admin で始まる Anthropic プロバイダー認証情報は、自動的に検出されます。
• OpenAI ChatGPT／Codex OAuth では、引き続きプラン、クォータ期間、クレジット残高が表示されます。代わりに組織のコストおよび completions 使用量履歴を表示するには、OPENAI_ADMIN_KEY を設定します。必要に応じて OPENAI_PROJECT_ID を設定すると、1 つのプロジェクトに限定できます。OpenClaw は、OPENAI_API_KEY、プロバイダー設定、または認証プロファイルの推論用認証情報を組織 API に送信することはありません。これらのキーがカスタムエンドポイントに属している可能性があるためです。

​

デフォルトの使用量フッターモード

{
  "messages": {
    "responseUsage": "tokens",
    // または: { "default": "off", "discord": "full" }
  },
}

​

3 つの異なるセッション状態

​

優先順位

​

リセットとオフの違い

• /usage off はフッターを強制的にオフにし、その選択を永続化します。設定されたオフ以外のデフォルトでこれを上書きすることはできません。
• /usage reset（エイリアス：default、inherit、inherited、clear、unpin）は、セッションの上書きをクリアします。その後、セッションは有効な設定デフォルト（messages.responseUsage）を継承します。デフォルトが設定されていない場合、フッターはオフのままです。
• 完全なセッションリセット（/reset または /new）やセッションのロールオーバーでも、明示的な使用量モード設定は保持されるため、ユーザーの表示選択はセッションのロールオーバー後も維持されます。上書きをクリアするのは /usage reset（およびそのエイリアス）のみです。

​

切り替え動作

​

設定

​

カスタム /usage full フッター

{
  "messages": {
    "usageTemplate": "~/.openclaw/usage-footer.json"
  }
}

{
  "schema": "openclaw.usageBar.v1",
  "scales": {
    "braille": "⠐⡀⡄⡆⡇⣇⣧⣷⣿",
    "block": "░▏▎▍▌▋▊▉█",
    "shade": "░▒▓█",
    "moon": "🌑🌘🌗🌖🌕",
    "level": "▁▂▃▄▅▆▇█",
    "weather": ["🥶", "☁️", "🌥", "⛅️", "🌤", "☀️"],
    "plants": ["🪾", "🍂", "🌱", "☘️", "🍀", "🌿"],
    "moons6": ["🌑", "🌚", "🌘", "🌗", "🌖", "🌝"],
  },
  "aliases": {
    "models": {
      "claude-opus-4-6": "opus46",
      "claude-opus-4-8": "opus48",
      "claude-sonnet-4-6": "sonnet46",
      "claude-haiku-4-5": "haiku45",
      "gpt-5.5": "gpt5.5",
    },
    "reasoning": {
      "off": "🌑",
      "minimal": "🌚",
      "low": "🌘",
      "medium": "🌗",
      "high": "🌕",
      "xhigh": "🌝",
    },
  },
  "output": {
    "sep": "",
    "default": [
      { "text": "{model.provider}{identity.emoji|🤖}{model.display_name|alias:models}" },
      { "map": "model.is_fallback", "cases": { "true": "🔄" } },
      { "map": "model.is_override", "cases": { "true": "📌" } },
      { "when": "model.reasoning", "text": "{model.reasoning|alias:reasoning}" },
      { "map": "state.fast_mode", "cases": { "true": "⚡️", "false": "🐌" } },
      {
        "when": "context.max_tokens",
        "text": " | 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}",
      },
      { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" },
    ],
    "surfaces": {
      "discord": [
        { "text": "-# -\n" },
        { "text": "-# {model.provider}{identity.emoji|🤖}{model.display_name|alias:models}" },
        { "map": "model.is_fallback", "cases": { "true": "🔄" } },
        { "map": "model.is_override", "cases": { "true": "📌" } },
        { "when": "model.reasoning", "text": "{model.reasoning|alias:reasoning}" },
        { "map": "state.fast_mode", "cases": { "true": "⚡️", "false": "🐌" } },
        {
          "when": "context.max_tokens",
          "text": " | 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}",
        },
        { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" },
      ],
    },
  },
}

​

形式

{
  "schema": "openclaw.usageBar.v1",
  "scales": { "<name>": "低から高へのグリフ" }, // 文字列（1 文字／グリフ）または配列
  "aliases": { "<table>": { "<value>": "<label>" } },
  "output": {
    "sep": "", // 残った要素を結合
    "default": [/* pieces */], // 任意のサーフェスのフォールバック
    "surfaces": {
      "discord": [/* pieces */],
      "telegram": [/* pieces */],
    },
  },
}

​

コントラクトパス

​

動詞

​

ピースの形式

• { "text": "📚 {context.max_tokens|num}" }：リテラル + 補間。
• { "when": "<path>", "text": "..." }：パスが真値の場合のみレンダリング。
• { "map": "<path>", "cases": { "true": "⚡", "false": "🐌" } }：値をグリフに変換（_default ケースが一致しない値を処理）。
• { "each": "<array-path>", "item": "{label}" }：配列値のパスを反復（現在の契約では配列となるパスはありません）。

​

例

{
  "schema": "openclaw.usageBar.v1",
  "scales": { "braille": "⠐⡀⡄⡆⡇⣇⣧⣷⣿" },
  "aliases": { "reasoning": { "medium": "🌗", "high": "🌕" } },
  "output": {
    "surfaces": {
      "discord": [
        { "text": "{model.display_name}" },
        { "when": "model.reasoning", "text": " {model.reasoning|alias:reasoning}" },
        { "map": "state.fast_mode", "cases": { "true": " ⚡", "false": " 🐌" } },
        {
          "when": "context.max_tokens",
          "text": " | 📚 [{context.pct_used|meter:5:braille}]{context.max_tokens|num}",
        },
      ],
    },
  },
}

​

プロバイダーと認証情報

• Anthropic（Claude）：認証プロファイル内の OAuth トークン。OAuth トークンに user:profile スコープがない場合、設定されていれば claude.ai Web セッション（CLAUDE_AI_SESSION_KEY、 CLAUDE_WEB_SESSION_KEY、または CLAUDE_WEB_COOKIE 内の sessionKey= Cookie）にフォールバックします。 Anthropic から報告された場合は、モデル単位の制限と、有効化された追加使用量の月間支出/予算が 含まれます。明示的な Anthropic Admin API キー、または 自動検出された sk-ant-admin... プロバイダープロファイルを使用すると、代わりに過去 30 日間の 組織コストと Messages API 履歴が表示されます。
• ClawRouter：API キー（CLAWROUTER_API_KEY）。設定されている場合は月次予算ウィンドウと 型付きの USD 予算を表示します。それ以外の場合は、支出合計と リクエスト/トークン/コストの概要を表示します。
• DeepSeek：環境変数/設定/認証ストア経由の API キー（DEEPSEEK_API_KEY）。 プロバイダーから報告された各通貨の残高を表示します。
• GitHub Copilot：認証プロファイル内の OAuth トークン。
• Gemini CLI：認証プロファイル内の OAuth トークン。
• MiniMax：API キーまたは MiniMax OAuth 認証プロファイル。OpenClaw は minimax、minimax-cn、minimax-portal を同じ MiniMax クォータ サーフェスとして扱い、保存済みの MiniMax OAuth が存在する場合はそれを優先し、それ以外の場合は MINIMAX_CODE_PLAN_KEY、MINIMAX_CODING_API_KEY、または MINIMAX_API_KEY にフォールバックします。 使用量のポーリングでは、設定されている場合は models.providers.minimax-portal.baseUrl または models.providers.minimax.baseUrl から Coding Plan ホストを導出し、それ以外の場合は MiniMax CN ホストを使用します。 MiniMax の生の usage_percent / usagePercent フィールドは残り クォータを意味するため、OpenClaw は表示前に値を反転します。存在する場合は カウントベースのフィールドが優先されます。
  • ウィンドウラベルは、存在する場合はプロバイダーの時間/分フィールドから取得し、それ以外の場合は start_time / end_time の期間にフォールバックします。
  • コーディングプランのエンドポイントが model_remains を返す場合、OpenClaw は チャットモデルのエントリを優先し、明示的な window_hours / window_minutes フィールドがない場合はタイムスタンプからウィンドウラベルを導出し、プラン ラベルにモデル名を含めます。
• OpenAI（Codex/ChatGPT プラン）：認証プロファイル内の OAuth トークン（アカウント ID がある場合は ChatGPT-Account-Id ヘッダーを送信）。ChatGPT プラン、リセット可能な Codex ウィンドウ、報告された場合はクレジット残高を表示します。クレジットはプロバイダーの クレジットのままであり、OpenClaw はドルとして表示しません。OPENAI_ADMIN_KEY は、 キーに Usage Dashboard へのアクセス権がある場合、過去 30 日間の組織コストと completions 使用量履歴を追加します。 推論用の認証情報が組織 API に転送されることはありません。
• OpenRouter：API キーまたは OAuth を基盤とする API キー（OPENROUTER_API_KEY または認証 プロファイル）。アカウントクレジットエンドポイントとキークォータエンドポイントを組み合わせるため、 認証情報からアクセスできる場合は、アカウント残高/支出、キー予算、日次/週次/月次の使用量が 表示されます。どちらのエンドポイントも個別にスナップショットを 補足できます。
• Venice：環境変数/設定/認証ストア経由の API キー（VENICE_API_KEY）。報告された場合は USD と DIEM の残高、および DIEM エポック割り当ての使用量を表示します。
• Xiaomi MiMo：2 つの独立した使用量サーフェス。従量課金では API キー （XIAOMI_API_KEY）を使用し、Token Plan では別のキー（XIAOMI_TOKEN_PLAN_API_KEY）を使用します。 現在、どちらもクォータウィンドウを報告しません。
• z.ai：環境変数/設定/認証ストア経由の API キー（ZAI_API_KEY または Z_AI_API_KEY）。

​

関連項目

• トークン使用量とコスト
• API 使用量とコスト
• プロンプトキャッシュ
• メニューバー