> ## 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. # Gebruik bijhouden ## Wat het is * Haalt providergebruik/quota rechtstreeks op uit hun gebruikseindpunten. * Geen geschatte kosten; alleen door de aanbieder gerapporteerde quotavensters of samenvattingen van accountstatus. * Menselijk leesbare statusuitvoer voor quotavensters wordt genormaliseerd naar `X% over`, zelfs wanneer een upstream-API verbruikte quota, resterende quota of alleen ruwe aantallen rapporteert. Aanbieders zonder resetbare quotavensters kunnen in plaats daarvan samenvattende aanbiedertekst tonen, zoals een saldo. * `/status` en `session_status` op sessieniveau kunnen terugvallen op de nieuwste transcript-gebruiksvermelding wanneer de live sessiesnapshot beperkt is. Die fallback vult ontbrekende token-/cachetellers aan, kan het actieve runtime- modellabel herstellen, en geeft de voorkeur aan het grotere promptgerichte totaal wanneer sessie- metadata ontbreekt of kleiner is. Bestaande niet-nul live waarden blijven leidend. ## Waar het verschijnt * `/status` in chats: statuskaart met veel emoji's, met sessietokens + geschatte kosten (alleen API-sleutel). Providergebruik wordt voor de **huidige modelaanbieder** getoond wanneer beschikbaar als een genormaliseerd venster `X% over` of samenvattende aanbiedertekst. * `/usage off|tokens|full` in chats: gebruiksvoettekst per antwoord. * `/usage cost` in chats: lokale kostensamenvatting, geaggregeerd uit OpenClaw-sessielogs. * CLI: `openclaw status --usage` print een volledige uitsplitsing per aanbieder. * CLI: `openclaw channels list` print dezelfde gebruikssnapshot naast de aanbiederconfiguratie (gebruik `--no-usage` om over te slaan). * macOS-menubalk: sectie "Gebruik" onder Context (alleen indien beschikbaar). ## Standaardmodus voor gebruiksvoettekst `/usage off|tokens|full` stelt de voettekst voor een sessie in en wordt voor die sessie onthouden. `messages.responseUsage` vult die modus vooraf in voor sessies die nog geen keuze hebben gemaakt, zodat de voettekst standaard aan kan staan zonder elke keer `/usage` te typen. Stel één modus in voor elk kanaal, of een kaart per kanaal met een `default`-fallback: ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "messages": { "responseUsage": "tokens", // or: { "default": "off", "discord": "full" } }, } ``` ### Drie onderscheidende sessiestatussen Het veld `responseUsage` van een sessie heeft drie representeerbare statussen, elk met andere semantiek: | Status | Opgeslagen waarde | Effectieve modus | | -------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------ | | **Niet ingesteld / erven** | `undefined` (afwezig) | Valt door naar de configuratiestandaard `messages.responseUsage`, daarna `off`. | | **Expliciet uit** | `"off"` (opgeslagen) | Altijd uit — een niet-uit configuratiestandaard kan de voettekst niet opnieuw inschakelen. | | **Expliciet aan** | `"tokens"` of `"full"` (opgeslagen) | Die modus, ongeacht de configuratiestandaard. | ### Prioriteit Effectieve modus = sessie-override → kanaalconfiguratie-item → `default` → `off`. Een expliciete `/usage off` wordt **blijvend opgeslagen** als de letterlijke waarde `"off"` in de sessie, niet hetzelfde als "niet ingesteld". Dit betekent dat een niet-uit standaard voor `messages.responseUsage` de voettekst niet weer kan inschakelen nadat de gebruiker die expliciet heeft uitgeschakeld. ### Resetten versus uitschakelen * `/usage off` — forceert de voettekst uit en slaat die keuze blijvend op. Een geconfigureerde niet-uit standaard kan dit niet overschrijven. * `/usage reset` (aliassen: `inherit`, `clear`, `default`) — wist de sessie- override. De sessie **erft** daarna de effectieve configuratiestandaard (`messages.responseUsage`). Als er geen standaard is geconfigureerd, staat de voettekst uit (ongewijzigd ten opzichte van eerder). Gebruik dit om "terug te gaan naar standaard" zonder de voettekst expliciet in te schakelen. * Een volledige sessiereset (`/reset` of `/new`) of een sessierollover **behoudt** de expliciete voorkeur voor de gebruiksmodus, zodat de weergavekeuze van de gebruiker sessierollovers overleeft. Alleen `/usage reset` (en de aliassen ervan) wist daadwerkelijk de override. ### Toggle-gedrag `/usage` zonder argumenten doorloopt: uit → tokens → volledig → uit. Het startpunt voor de cyclus is de **effectieve** huidige modus (sessie-override die doorvalt naar de configuratiestandaard wanneer niet ingesteld), dus de cyclus is altijd consistent met wat de gebruiker in de voettekst ziet. ### Configuratie Zonder configuratie blijft het eerdere gedrag gelden (voettekst uit tot `/usage`). Gebruik `/usage reset` om een sessie-override te wissen en de geconfigureerde standaard opnieuw te erven. ## Aangepaste voettekst voor `/usage full` `/usage full` toont een ingebouwde compacte voettekst met model, redenering, snel/langzaam, contextvenster en kosten wanneer die velden beschikbaar zijn. Token- en cachevelden blijven beschikbaar voor aangepaste templates. Er is geen templatebestand vereist. `messages.usageTemplate` is alleen voor geavanceerde aangepaste indelingen. De waarde is een JSON-bestandspad (ondersteunt `~`) of een inline object, en vervangt de ingebouwde voettekst wanneer geldig: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` Ontbrekende of lege templates vallen stil terug op de ingebouwde voettekst. Onleesbare of ongeldige geconfigureerde templates vallen ook terug op de ingebouwde voettekst en geven een operatorwaarschuwing. Begin aangepaste templates vanuit de ingebouwde vorm en bewerk daarna de onderdelen die je wilt wijzigen: ```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": "\u00A0| 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}", }, { "when": "cost.turn_usd", "text": "\u00A0💰{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": "\u00A0| 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}", }, { "when": "cost.turn_usd", "text": "\u00A0💰{cost.turn_usd|fixed:4}" }, ], }, }, } ``` ### Vorm ```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": { "": { "": "