Nutzungsverfolgung

Was es ist

• Ruft Nutzung/Kontingent direkt vom Nutzungsendpunkt jedes Providers ab. Keine geschätzte Provider-Abrechnung; ausschließlich vom Provider gemeldete Plannamen, Kontingentzeiträume, Guthaben, Ausgaben, Budgets, täglicher Kostenverlauf, Token-/Modellzuordnung oder Zusammenfassungen des Kontostatus.
• Die menschenlesbare Ausgabe für Kontingentzeiträume wird auf X% left normalisiert, selbst wenn ein Provider verbrauchtes Kontingent, verbleibendes Kontingent oder nur Rohwerte meldet. Provider ohne zurücksetzbare Kontingentzeiträume zeigen stattdessen einen Provider-Zusammenfassungstext an (beispielsweise ein Guthaben).
• Das sitzungsbezogene /status und das Tool session_status greifen auf das Transkriptprotokoll der Sitzung zurück, wenn im Live-Sitzungssnapshot Token-/Modelldaten fehlen. Dieser Rückgriff ergänzt fehlende Token-/Cache-Zähler, kann die Bezeichnung des aktiven Laufzeitmodells wiederherstellen und bevorzugt den größeren promptorientierten Gesamtwert, wenn Sitzungsmetadaten fehlen oder kleiner sind (totalTokensFresh !== true, null oder unter dem aus dem Transkript abgeleiteten Wert). Live-Werte ungleich null haben stets Vorrang vor diesem Rückgriff.

Wo es angezeigt wird

• /status in Chats: Statuskarte mit Sitzungstoken und geschätzten Kosten (nur Modelle mit API-Schlüssel). Die Provider-Nutzung wird, sofern verfügbar, für den Provider des aktuellen Modells als normalisierter Zeitraum X% left oder als Provider-Zusammenfassungstext angezeigt.
• /usage off|tokens|full in Chats: Nutzungsfußzeile pro Antwort.
• /usage cost in Chats: lokale Kostenzusammenfassung, aggregiert aus OpenClaw-Sitzungsprotokollen.
• CLI: openclaw status --usage gibt eine vollständige Aufschlüsselung von Nutzung und Kontingent pro Provider aus.
• CLI: openclaw models status listet OAuth-/Token-Authentifizierungsprofile auf und zeigt neben jedem Provider, für den eine solche vorhanden ist, eine Zusammenfassung des Nutzungszeitraums an.
• Control UI: Nutzung zeigt Karten für Provider-Plan und -Abrechnung oberhalb der aus OpenClaw-Sitzungen abgeleiteten Token- und geschätzten Kostenanalyse. Anmeldedaten für die Admin-APIs von Anthropic und OpenAI ergänzen vom Provider gemeldete Ausgaben für heute, 7 Tage und 30 Tage, tägliche Trends, Token-Gesamtwerte, meistgenutzte Modelle und Kostenkategorien.
• Control UI: Das Kontextkreis-Popover des Chat-Eingabefelds zeigt die Plannutzung für Abonnement-Provider – Balken pro Zeitraum (5 Stunden, wöchentlich, modellspezifisch) mit Rücksetzzeiten, den Provider-Plan, sofern bekannt (beispielsweise Max (20x)), und Guthaben für zusätzliche Nutzung. Über einen Plan abgerechnete Sitzungen blenden Dollar-Schätzungen pro Token aus; über die API abgerechnete Sitzungen behalten Est. cost und die Kostenaufschlüsselung nach Typ bei. Claude-Code-CLI-Konfigurationen (claude-cli) verwenden dieselbe Anthropic-Abonnementnutzung.
• macOS-Menüleiste: Unter Kontext wird ein Hauptabschnitt „Nutzung“ angezeigt, wenn Snapshots der Provider-Nutzung verfügbar sind. Siehe Menüleiste.

openclaw channels list gibt die Provider-Nutzung nicht mehr aus; stattdessen verweist es Benutzer auf openclaw status oder openclaw models list.

Kostenverlauf von Anthropic und OpenAI

Abonnementkontingent und API-Abrechnung sind unterschiedliche Provider-Oberflächen:

• Anmeldedaten für Anthropic-Abonnements/-Konfigurationen zeigen weiterhin Claude-Kontingentzeiträume und optionale Budgets für zusätzliche Nutzung an. Legen Sie ANTHROPIC_ADMIN_KEY oder ANTHROPIC_ADMIN_API_KEY fest, um stattdessen den Verlauf der organisationsweiten Usage and Cost API anzuzeigen. Provider-Anmeldedaten von Anthropic, die mit sk-ant-admin beginnen, werden automatisch erkannt.
• OpenAI-ChatGPT-/Codex-OAuth zeigt weiterhin Plan, Kontingentzeiträume und Guthaben an. Legen Sie OPENAI_ADMIN_KEY fest, um stattdessen den Verlauf der organisationsweiten Kosten und Abschlussnutzung anzuzeigen; legen Sie optional OPENAI_PROJECT_ID fest, um ihn auf ein Projekt zu beschränken. OpenClaw sendet niemals Inferenz-Anmeldedaten aus OPENAI_API_KEY, der Provider-Konfiguration oder Authentifizierungsprofilen an Organisations-APIs, da diese Schlüssel zu benutzerdefinierten Endpunkten gehören können.

Admin-Anmeldedaten haben Vorrang, da sie die tatsächliche Organisationsabrechnung bereitstellen. OpenClaw kombiniert diese vom Provider gemeldeten Gesamtwerte nicht mit seinen lokalen Sitzungsschätzungen; die beiden Abschnitte beantworten absichtlich unterschiedliche Fragen.

Standardmodus der Nutzungsfußzeile

/usage off|tokens|full legt die Fußzeile für eine Sitzung fest und wird für diese Sitzung gespeichert. messages.responseUsage legt diesen Modus als Ausgangswert für Sitzungen fest, die noch keinen ausgewählt haben, sodass die Fußzeile standardmäßig aktiviert sein kann, ohne jedes Mal /usage einzugeben.

Legen Sie einen Modus für jeden Kanal oder eine kanalspezifische Zuordnung mit einem default-Rückgriff fest:

{  "messages": {    "responseUsage": "tokens",    // oder: { "default": "off", "discord": "full" }  },}

Akzeptierte Werte: "off", "tokens", "full" und der veraltete Alias "on" (wird als "tokens" behandelt).

Drei unterschiedliche Sitzungszustände

Das Feld responseUsage einer Sitzung kann drei Zustände darstellen, die jeweils unterschiedliche Semantiken haben:

Rangfolge

Wirksamer Modus = Sitzungsüberschreibung → Kanalkonfigurationseintrag → default → off.

Ein explizites /usage off wird als Literalwert "off" in der Sitzung dauerhaft gespeichert und ist nicht dasselbe wie „nicht gesetzt“. Ein Standardwert messages.responseUsage, der nicht „aus“ ist, kann die Fußzeile nicht wieder aktivieren, nachdem der Benutzer sie ausdrücklich deaktiviert hat.

Zurücksetzen oder Ausschalten

• /usage off erzwingt das Ausschalten der Fußzeile und speichert diese Auswahl dauerhaft. Ein konfigurierter Standardwert ungleich „aus“ kann dies nicht überschreiben.
• /usage reset (Aliasse: default, inherit, inherited, clear, unpin) löscht die Sitzungsüberschreibung. Die Sitzung übernimmt anschließend den wirksamen Konfigurationsstandard (messages.responseUsage). Ist kein Standard konfiguriert, bleibt die Fußzeile ausgeschaltet.
• Ein vollständiges Zurücksetzen der Sitzung (/reset oder /new) oder ein Sitzungswechsel behält die explizite Einstellung des Nutzungsmodus bei, sodass die Anzeigeauswahl des Benutzers Sitzungswechsel überdauert. Nur /usage reset (und seine Aliasse) löscht die Überschreibung.

Umschaltverhalten

/usage ohne Argumente wechselt zyklisch: aus → Token → vollständig → aus. Der Ausgangspunkt des Zyklus ist der wirksame aktuelle Modus (die Sitzungsüberschreibung greift, wenn sie nicht gesetzt ist, auf den Konfigurationsstandard zurück), sodass der Zyklus stets dem entspricht, was der Benutzer derzeit in der Fußzeile sieht.

Konfiguration

Ohne Konfiguration bleibt das bisherige Verhalten bestehen (Fußzeile aus, bis /usage). Verwenden Sie /usage reset, um eine Sitzungsüberschreibung zu löschen und den konfigurierten Standard erneut zu übernehmen.

Benutzerdefinierte /usage full-Fußzeile

/usage tokens rendert stets eine einfache Usage: X in / Y out-Zeile (zuzüglich Cache- und geschätzter Kostenzusätze, sofern verfügbar). Nur /usage full rendert die nachfolgend beschriebene umfangreichere Fußzeile.

/usage full zeigt eine integrierte kompakte Fußzeile mit Modell, Reasoning, schnell/langsam, Kontextfenster und Kosten an, sofern diese Felder verfügbar sind. Für die integrierte Fußzeile ist keine Vorlagendatei erforderlich.

messages.usageTemplate ist ausschließlich für fortgeschrittene benutzerdefinierte Layouts vorgesehen. Der Wert ist ein JSON-Dateipfad (unterstützt ~) oder ein Inline-Objekt und ersetzt die integrierte Fußzeile, wenn er gültig ist. Ein Dateipfad wird überwacht und bei Änderungen live neu geladen.

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

Fehlende oder leere Vorlagen greifen ohne Meldung auf die integrierte Fußzeile zurück. Nicht lesbare oder ungültige konfigurierte Vorlagen (fehlerhaftes JSON oder eine Struktur ohne renderbare Ausgabebestandteile) greifen ebenfalls auf die integrierte Fußzeile zurück und geben eine Warnung für den Betreiber aus.

Beginnen Sie benutzerdefinierte Vorlagen mit der integrierten Struktur und bearbeiten Sie anschließend die Teile, die Sie ändern möchten:

{  "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}" },      ],    },  },}

Struktur

{  "schema": "openclaw.usageBar.v1",  "scales": { "<name>": "Glyphen von niedrig bis hoch" }, // Zeichenfolge (1 Glyphe/Zeichen) oder Array  "aliases": { "<table>": { "<value>": "<label>" } },  "output": {    "sep": "", // verbindet verbleibende Bestandteile    "default": [/* pieces */], // Rückgriff für jede Oberfläche    "surfaces": {      "discord": [/* pieces */],      "telegram": [/* pieces */],    },  },}

Jede Oberfläche ist eine geordnete Liste von Bestandteilen; die Engine rendert jeden Bestandteil, verwirft leere und verbindet die verbleibenden mit sep. Eine Oberfläche ohne Eintrag verwendet output.default.

Vertragspfade

Ein Bestandteil liest Werte über einen Punktpfad aus dem Vertrag pro Durchlauf. Nicht vorhandene Werte sind leer (sodass eine when-Bedingung oder ein |fallback den Bestandteil sauber hält).

(Provider-Zeitfenster für Ratenbegrenzungen sind nicht Teil dieses Vertrags; derzeit gibt es keinen Pfad mit einem Array-Wert, daher kann ein each-Element über nichts iterieren.)

Verben

Leiten Sie einen Wert von links nach rechts durch Verben; ein Segment, das kein Verb ist, dient als Fallback.

fixed:N akzeptiert nur eine vollständige dezimale Ganzzahl von 0 bis 100. Ungültige Genauigkeitsargumente führen dazu, dass diese Interpolation leer bleibt.

meter:W:SCALE akzeptiert nur eine vollständige dezimale Ganzzahl als Breite von 1 bis 100. Lassen Sie die Breite leer, um den Standardwert 5 (meter::braille) zu verwenden; ungültige Breiten führen dazu, dass diese Interpolation leer bleibt.

Elementformen

• { "text": "📚 {context.max_tokens|num}" }: Literal + Interpolation.
• { "when": "<path>", "text": "..." }: nur rendern, wenn der Pfad einen Wahrheitswert ergibt.
• { "map": "<path>", "cases": { "true": "⚡", "false": "🐌" } }: Wert einer Glyphe zuordnen (ein _default-Fall deckt nicht übereinstimmende Werte ab).
• { "each": "<array-path>", "item": "{label}" }: über einen Pfad mit Array-Wert iterieren (kein aktueller Vertragspfad ist ein Array).

Beispiel

{  "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}",        },      ],    },  },}

rendert beispielsweise claude-sonnet-4-6 🌗 🐌 | 📚 [⣿⣿⣿⣿⣧]272k.

Provider + Anmeldedaten

Die Nutzung wird ausgeblendet, wenn keine verwendbare Provider-Authentifizierung für Nutzungsdaten aufgelöst werden kann. OpenClaw erkennt automatisch aktivierte Provider-Plugins, die contracts.usageProviders deklarieren und sowohl resolveUsageAuth als auch fetchUsageSnapshot implementieren; es gibt keine separate Zulassungsliste für Core-Provider. Der statische Vertrag begrenzt den Umfang der Erkennung, ohne jedes Provider-Plugin zu importieren. Jedes Plugin ist für seinen Upstream-Endpunkt und die Zuordnung der Antworten zuständig. Der gemeinsame Snapshot hält Plannamen, Kontingentfenster, Salden, Ausgaben und Budgets Provider-neutral für Verbraucher in CLI, App und Control UI.

• Anthropic (Claude): OAuth-Token in Authentifizierungsprofilen. Wenn dem OAuth-Token der Geltungsbereich user:profile fehlt, erfolgt bei entsprechender Konfiguration ein Fallback auf eine claude.ai-Websitzung (CLAUDE_AI_SESSION_KEY, CLAUDE_WEB_SESSION_KEY oder ein sessionKey=-Cookie in CLAUDE_WEB_COOKIE). Modellspezifische Limits sowie aktivierte monatliche Ausgaben/Budgets für zusätzliche Nutzung werden einbezogen, wenn Anthropic sie meldet. Ein expliziter Anthropic-Admin-API-Schlüssel oder ein automatisch erkanntes sk-ant-admin...-Providerprofil zeigt stattdessen die Organisationskosten der letzten 30 Tage und den Verlauf der Messages API.
• ClawRouter: API-Schlüssel (CLAWROUTER_API_KEY). Zeigt ein monatliches Budgetfenster und ein typisiertes USD-Budget an, wenn es konfiguriert ist; andernfalls werden die Gesamtausgaben und eine Zusammenfassung von Anfragen, Token und Kosten angezeigt.
• DeepSeek: API-Schlüssel über Umgebung/Konfiguration/Authentifizierungsspeicher (DEEPSEEK_API_KEY). Zeigt jeden vom Provider gemeldeten Währungssaldo an.
• GitHub Copilot: OAuth-Token in Authentifizierungsprofilen.
• Gemini CLI: OAuth-Token in Authentifizierungsprofilen.
• MiniMax: API-Schlüssel oder MiniMax-OAuth-Authentifizierungsprofil. OpenClaw behandelt minimax, minimax-cn und minimax-portal als dieselbe MiniMax-Kontingentoberfläche, bevorzugt vorhandenes gespeichertes MiniMax-OAuth und verwendet andernfalls als Fallback MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY oder MINIMAX_API_KEY. Die Nutzungsabfrage leitet den Coding-Plan-Host aus models.providers.minimax-portal.baseUrl oder models.providers.minimax.baseUrl ab, wenn diese konfiguriert sind, und verwendet andernfalls den MiniMax-CN-Host. Die Rohfelder usage_percent / usagePercent von MiniMax geben das verbleibende Kontingent an, daher invertiert OpenClaw sie vor der Anzeige; anzahlbasierte Felder haben Vorrang, wenn sie vorhanden sind.
  • Fensterbezeichnungen stammen, sofern vorhanden, aus den Stunden-/Minutenfeldern des Providers und verwenden anschließend als Fallback die Spanne start_time / end_time.
  • Wenn der Coding-Plan-Endpunkt model_remains zurückgibt, bevorzugt OpenClaw den Chatmodelleintrag, leitet die Fensterbezeichnung aus Zeitstempeln ab, wenn explizite Felder window_hours / window_minutes fehlen, und nimmt den Modellnamen in die Planbezeichnung auf.
• OpenAI (Codex-/ChatGPT-Plan): OAuth-Token in Authentifizierungsprofilen (der ChatGPT-Account-Id-Header wird gesendet, wenn eine Konto-ID vorhanden ist). Zeigt den ChatGPT-Plan, zurücksetzbare Codex-Fenster und einen Kreditsaldo an, wenn diese gemeldet werden. Kredite bleiben Provider- Kredite; OpenClaw kennzeichnet sie nicht als Dollar. OPENAI_ADMIN_KEY ergänzt die Organisationskosten der letzten 30 Tage und den Verlauf der Completions-Nutzung, wenn der Schlüssel Zugriff auf das Usage Dashboard hat. Anmeldedaten für Inferenz werden niemals an Organisations-APIs weitergeleitet.
• OpenRouter: API-Schlüssel oder OAuth-gestützter API-Schlüssel (OPENROUTER_API_KEY oder ein Authentifizierungsprofil). Kombiniert den Endpunkt für Kontoguthaben mit dem Endpunkt für Schlüssellimits, sodass Kontosaldo/-ausgaben, Schlüsselbudget und tägliche/wöchentliche/monatliche Nutzung angezeigt werden, wenn die Anmeldedaten darauf zugreifen können. Beide Endpunkte können den Snapshot unabhängig voneinander anreichern.
• Venice: API-Schlüssel über Umgebung/Konfiguration/Authentifizierungsspeicher (VENICE_API_KEY). Zeigt USD- und DIEM-Salden sowie die Nutzung der DIEM-Epochenzuweisung an, wenn diese gemeldet werden.
• Xiaomi MiMo: zwei separate Nutzungsoberflächen. Die nutzungsabhängige Abrechnung verwendet einen API-Schlüssel (XIAOMI_API_KEY); der Token-Plan verwendet einen separaten Schlüssel (XIAOMI_TOKEN_PLAN_API_KEY). Derzeit meldet keine der beiden Oberflächen Kontingentfenster.
• z.ai: API-Schlüssel über Umgebung/Konfiguration/Authentifizierungsspeicher (ZAI_API_KEY oder Z_AI_API_KEY).

Verwandte Themen

• Token-Nutzung und Kosten
• API-Nutzung und Kosten
• Prompt-Caching
• Menüleiste