> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # 使用状況の追跡 ## 概要 * 各プロバイダーの使用量エンドポイントから、プロバイダーの使用量/クォータを直接取得します。推定のプロバイダー課金額は含めません。プロバイダーが報告するプラン名、クォータ期間、残高、支出、予算、日次コスト履歴、トークン/モデルの内訳、またはアカウント状態の概要のみを表示します。 * 人間が読めるクォータ期間の出力は、プロバイダーが消費済みクォータ、残りクォータ、または生のカウントのみを報告する場合でも、`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 の下にルートの「使用量」セクションが表示されます。[メニューバー](/ja-JP/platforms/mac/menu-bar)を参照してください。 `openclaw channels list` はプロバイダー使用量を出力しなくなりました。代わりに `openclaw status` または `openclaw models list` を案内します。 ## Anthropic と OpenAI のコスト履歴 サブスクリプションクォータと API 課金は、異なるプロバイダーサーフェスです。 * 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 に送信しません。これらのキーはカスタムエンドポイントに属している可能性があるためです。 管理認証情報は実際の組織課金を提供するため優先されます。OpenClaw は、これらのプロバイダー報告合計をローカルセッション推定値と合算しません。この 2 つのセクションは意図的に異なる問いに答えます。 ## デフォルトの使用量フッターモード `/usage off|tokens|full` はセッションのフッターを設定し、そのセッションに記憶されます。`messages.responseUsage` は、まだ選択していないセッションにそのモードをシードするため、毎回 `/usage` を入力しなくてもフッターをデフォルトでオンにできます。 すべてのチャンネルに 1 つのモードを設定するか、`default` フォールバック付きのチャンネル別マップを設定します。 ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "messages": { "responseUsage": "tokens", // or: { "default": "off", "discord": "full" } }, } ``` 受け付ける値: `"off"`、`"tokens"`、`"full"`、およびレガシーエイリアス `"on"`（`"tokens"` として扱われます）。 ### 3 つの異なるセッション状態 セッションの `responseUsage` フィールドには、表現可能な 3 つの状態があり、それぞれ意味が異なります。 | 状態 | 保存値 | 実効モード | | ------------ | ------------------------------- | ----------------------------------------------------- | | **未設定 / 継承** | `undefined` (absent) | `messages.responseUsage` 設定のデフォルトにフォールスルーし、その後 `off`。 | | **明示的にオフ** | `"off"` (stored) | 常にオフ。オフ以外の設定デフォルトではフッターを再有効化できません。 | | **明示的にオン** | `"tokens"` or `"full"` (stored) | 設定デフォルトに関係なく、そのモード。 | ### 優先順位 実効モード = セッション上書き → チャンネル設定エントリ → `default` → `off`。 明示的な `/usage off` は、セッション内にリテラル値 `"off"` として**永続化**され、「未設定」と同じではありません。オフ以外の `messages.responseUsage` デフォルトは、ユーザーが明示的に無効化した後にフッターを再びオンにすることはできません。 ### リセットとオフの違い * `/usage off` はフッターを強制的にオフにし、その選択を永続化します。設定されたオフ以外のデフォルトでこれを上書きすることはできません。 * `/usage reset`（エイリアス: `default`、`inherit`、`inherited`、`clear`、`unpin`）はセッション上書きをクリアします。その後、セッションは実効設定デフォルト（`messages.responseUsage`）を**継承**します。デフォルトが設定されていない場合、フッターはオフのままです。 * 完全なセッションリセット（`/reset` または `/new`）またはセッションロールオーバーは、明示的な使用量モード設定を**保持**するため、ユーザーの表示選択はセッションロールオーバー後も維持されます。上書きをクリアするのは `/usage reset`（およびそのエイリアス）のみです。 ### トグル動作 引数なしの `/usage` は、オフ → tokens → full → オフの順に切り替えます。サイクルの開始点は現在の**実効**モード（未設定の場合はセッション上書きが設定デフォルトにフォールスルー）であるため、サイクルは常にユーザーが現在フッターで見ているものと一致します。 ### 設定 設定がない場合、従来の動作（`/usage` までフッターはオフ）が維持されます。セッション上書きをクリアして設定済みデフォルトを再継承するには、`/usage reset` を使用します。 ## カスタム `/usage full` フッター `/usage tokens` は常にプレーンな `Usage: X in / Y out` 行をレンダリングします（利用可能な場合はキャッシュと推定コストのサフィックスも追加）。以下で説明するより情報量の多いフッターをレンダリングするのは `/usage full` のみです。 `/usage full` は、これらのフィールドが利用可能な場合、モデル、reasoning、fast/slow、コンテキストウィンドウ、コストを含む組み込みのコンパクトなフッターを表示します。組み込みフッターにテンプレートファイルは不要です。 `messages.usageTemplate` は高度なカスタムレイアウト専用です。値は JSON ファイルパス（`~` 対応）またはインラインオブジェクトで、有効な場合は組み込みフッターを置き換えます。ファイルパスは監視され、変更時にライブで再読み込みされます。 ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` テンプレートがない、または空の場合は、静かに組み込みフッターへフォールバックします。読み取れない、または無効な設定済みテンプレート（不正な JSON、またはレンダリング可能な出力ピースがない形状）も組み込みフッターへフォールバックし、オペレーター警告を出します。 カスタムテンプレートは組み込み形状から始め、変更したい部分を編集します。 ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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}" }, ], }, }, } ``` ### 形状 ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "schema": "openclaw.usageBar.v1", "scales": { "": "low-to-high glyphs" }, // string (1 glyph/char) or array "aliases": { "": { "": "