Usage tracking
概要
- プロバイダーの使用量/クォータを、それぞれの使用量エンドポイントから直接取得します。
- 推定コストは使用せず、プロバイダーが報告するウィンドウのみを使用します。
- 人間向けのステータス出力は、上流APIが消費済みクォータ、残量クォータ、または生のカウントのみを返す場合でも、
X% leftに正規化されます。 - セッションレベルの
/statusとsession_statusは、ライブのセッションスナップショットの情報が少ない場合、最新のトランスクリプト使用量エントリーへフォールバックできます。このフォールバックは不足しているtoken/cacheカウンターを補い、アクティブなランタイムmodelラベルを復元でき、セッションメタデータがない場合またはそれより小さい場合には、より大きいプロンプト指向の合計を優先します。既存のゼロでないライブ値は引き続き優先されます。
表示される場所
- チャット内の
/status: セッショントークン + 推定コスト(API keyのみ)を含む絵文字付きステータスカード。プロバイダー使用量は、利用可能な場合、現在のモデルプロバイダーについて正規化されたX% leftウィンドウとして表示されます。 - チャット内の
/usage off|tokens|full: 返信ごとの使用量フッター(OAuthではtokensのみ表示)。 - チャット内の
/usage cost: OpenClawのセッションログから集計したローカルのコスト概要。 - CLI:
openclaw status --usageはプロバイダーごとの完全な内訳を表示します。 - CLI:
openclaw channels listは、同じ使用量スナップショットをプロバイダー設定と並べて表示します(スキップするには--no-usageを使用)。 - macOSメニューバー: Context配下の「Usage」セクション(利用可能な場合のみ)。
プロバイダー + 認証情報
- Anthropic (Claude): auth profile内のOAuthトークン。
- GitHub Copilot: auth profile内のOAuthトークン。
- Gemini CLI: auth profile内のOAuthトークン。
- JSON使用量は
statsにフォールバックします。stats.cachedはcacheReadに正規化されます。
- JSON使用量は
- OpenAI Codex: auth profile内のOAuthトークン(存在する場合はaccountIdを使用)。
- MiniMax: API keyまたはMiniMax OAuth auth profile。OpenClawは
minimax、minimax-cn、minimax-portalを同じMiniMaxクォータ表示として扱い、保存済みのMiniMax OAuthが存在する場合はそれを優先し、そうでなければMINIMAX_CODE_PLAN_KEY、MINIMAX_CODING_API_KEY、またはMINIMAX_API_KEYにフォールバックします。 MiniMaxの生のusage_percent/usagePercentフィールドは残量クォータを意味するため、OpenClawは表示前にそれらを反転します。カウントベースのフィールドが存在する場合はそちらが優先されます。- coding-planのウィンドウラベルは、存在する場合はプロバイダーのhours/minutesフィールドから取得し、その後、
start_time/end_timeの範囲にフォールバックします。 - coding-planエンドポイントが
model_remainsを返す場合、OpenClawはchat-modelエントリーを優先し、明示的なwindow_hours/window_minutesフィールドがないときはタイムスタンプからウィンドウラベルを導出し、プランラベルにmodel名を含めます。
- coding-planのウィンドウラベルは、存在する場合はプロバイダーのhours/minutesフィールドから取得し、その後、
- Xiaomi MiMo: env/config/auth store経由のAPI key(
XIAOMI_API_KEY)。 - z.ai: env/config/auth store経由のAPI key。