使用状況の追跡

​

概要

• 各プロバイダーの使用量エンドポイントから、プロバイダーの使用量/クォータを直接取得します。推定のプロバイダー課金額は含めません。プロバイダーが報告するプラン名、クォータ期間、残高、支出、予算、日次コスト履歴、トークン/モデルの内訳、またはアカウント状態の概要のみを表示します。
• 人間が読めるクォータ期間の出力は、プロバイダーが消費済みクォータ、残りクォータ、または生のカウントのみを報告する場合でも、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 管理 API の認証情報を追加すると、プロバイダーが報告する今日、7日間、30日間の支出、日次トレンド、トークン合計、上位モデル、コストカテゴリが表示されます。
• macOS メニューバー: プロバイダー使用量スナップショットが利用可能な場合、Context の下にルートの「使用量」セクションが表示されます。メニューバーを参照してください。

​

Anthropic と OpenAI のコスト履歴

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

​

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

{
  "messages": {
    "responseUsage": "tokens",
    // or: { "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>": "low-to-high glyphs" }, // string (1 glyph/char) or array
  "aliases": { "<table>": { "<value>": "<label>" } },
  "output": {
    "sep": "", // joins surviving pieces
    "default": [
      /* pieces */
    ], // fallback for any surface
    "surfaces": {
      "discord": [
        /* pieces */
      ],
      "telegram": [
        /* pieces */
      ],
    },
  },
}

​

コントラクトパス

​

動詞

​

ピース形式

• { "text": "📚 {context.max_tokens|num}" }: リテラル + 補間。
• { "when": "<path>", "text": "..." }: パスが truthy の場合のみレンダー。
• { "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: env/config/認証ストア経由の 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 は表示前に反転します。存在する場合は カウントベースのフィールドが優先されます。
  • ウィンドウラベルは、存在する場合はプロバイダーの hours/minutes フィールドから取得し、その後 start_time / end_time の範囲へフォールバックします。
  • Coding Plan エンドポイントが 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: env/config/認証ストア経由の API キー（VENICE_API_KEY）。報告される場合、USD と DIEM の残高に加えて DIEM エポック割り当て使用量を表示します。
• Xiaomi MiMo: 2 つの個別の使用量サーフェス。従量課金は API キー （XIAOMI_API_KEY）を使用し、Token Plan は別のキー（XIAOMI_TOKEN_PLAN_API_KEY）を使用します。 どちらも現在クォータウィンドウを報告しません。
• z.ai: env/config/認証ストア経由の API キー（ZAI_API_KEY または Z_AI_API_KEY）。

​

関連

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