--- read_when: - Konfigurujesz powierzchnie użycia/limitów dostawcy - Musisz wyjaśnić zachowanie śledzenia użycia lub wymagania dotyczące uwierzytelniania summary: Powierzchnie śledzenia użycia i wymagania dotyczące poświadczeń title: Śledzenie użycia x-i18n: generated_at: "2026-07-01T20:37:17Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: fa9b2b0b19ca0b4beeea40bfd50b07a92155178d5ec0e1877013843e0caba4fb source_path: concepts/usage-tracking.md workflow: 16 --- ## Czym to jest - Pobiera użycie/limity dostawcy bezpośrednio z jego endpointów użycia. - Bez szacowanych kosztów; tylko okna limitów lub podsumowania stanu konta raportowane przez dostawcę. - Czytelne dla człowieka wyjście stanu okna limitu jest normalizowane do `X% left`, nawet gdy nadrzędne API raportuje zużyty limit, pozostały limit albo tylko surowe liczby. Dostawcy bez resetowalnych okien limitów mogą zamiast tego pokazywać tekst podsumowania dostawcy, na przykład saldo. - `/status` na poziomie sesji i `session_status` mogą wrócić do najnowszego wpisu użycia z transkrypcji, gdy bieżący snapshot sesji jest skąpy. Ten mechanizm uzupełnia brakujące liczniki tokenów/pamięci podręcznej, może odzyskać etykietę aktywnego modelu środowiska uruchomieniowego i preferuje większą sumę zorientowaną na prompt, gdy metadanych sesji brakuje albo są mniejsze. Istniejące niezerowe wartości bieżące nadal mają pierwszeństwo. ## Gdzie się pojawia - `/status` w czatach: karta stanu bogata w emoji z tokenami sesji + szacowanym kosztem (tylko klucz API). Użycie dostawcy jest pokazywane dla **bieżącego dostawcy modelu**, gdy jest dostępne, jako znormalizowane okno `X% left` albo tekst podsumowania dostawcy. - `/usage off|tokens|full` w czatach: stopka użycia dla każdej odpowiedzi. - `/usage cost` w czatach: lokalne podsumowanie kosztów agregowane z logów sesji OpenClaw. - CLI: `openclaw status --usage` wypisuje pełny podział według dostawców. - CLI: `openclaw channels list` wypisuje ten sam snapshot użycia obok konfiguracji dostawcy (użyj `--no-usage`, aby pominąć). - Pasek menu macOS: sekcja „Użycie” pod Context (tylko jeśli dostępna). ## Domyślny tryb stopki użycia `/usage off|tokens|full` ustawia stopkę dla sesji i jest zapamiętywany dla tej sesji. `messages.responseUsage` ustawia początkowo ten tryb dla sesji, które go jeszcze nie wybrały, więc stopka może być domyślnie włączona bez wpisywania `/usage` za każdym razem. Ustaw jeden tryb dla każdego kanału albo mapę dla poszczególnych kanałów z zapasowym `default`: ```jsonc { "messages": { "responseUsage": "tokens", // or: { "default": "off", "discord": "full" } }, } ``` ### Trzy odrębne stany sesji Pole `responseUsage` sesji ma trzy reprezentowalne stany, każdy o innej semantyce: | Stan | Przechowywana wartość | Efektywny tryb | | ----------------------- | ------------------------------- | --------------------------------------------------------------------- | | **Nieustawione / dziedziczenie** | `undefined` (brak) | Przechodzi do domyślnej konfiguracji `messages.responseUsage`, potem `off`. | | **Jawnie wyłączone** | `"off"` (przechowywane) | Zawsze wyłączone — domyślna konfiguracja inna niż off nie może ponownie włączyć stopki. | | **Jawnie włączone** | `"tokens"` albo `"full"` (przechowywane) | Ten tryb, niezależnie od domyślnej konfiguracji. | ### Kolejność pierwszeństwa Efektywny tryb = nadpisanie sesji → wpis konfiguracji kanału → `default` → `off`. Jawne `/usage off` jest **utrwalane** jako dosłowna wartość `"off"` w sesji, a nie jako „nieustawione”. Oznacza to, że domyślne `messages.responseUsage` inne niż off nie może ponownie włączyć stopki po tym, jak użytkownik jawnie ją wyłączył. ### Resetowanie a wyłączanie - `/usage off` — wymusza wyłączenie stopki i utrwala ten wybór. Skonfigurowana wartość domyślna inna niż off nie może tego nadpisać. - `/usage reset` (aliasy: `inherit`, `clear`, `default`) — czyści nadpisanie sesji. Sesja następnie **dziedziczy** efektywną wartość domyślną konfiguracji (`messages.responseUsage`). Jeśli nie skonfigurowano wartości domyślnej, stopka jest wyłączona (bez zmiany względem wcześniej). Użyj tego, aby „wrócić do wartości domyślnej” bez jawnego włączania stopki. - Pełny reset sesji (`/reset` albo `/new`) lub rollover sesji **zachowuje** jawną preferencję trybu użycia, aby wybór wyświetlania użytkownika przetrwał rollovery sesji. Tylko `/usage reset` (i jego aliasy) faktycznie czyści nadpisanie. ### Zachowanie przełącznika `/usage` bez argumentów przełącza cyklicznie: off → tokens → full → off. Punktem startowym cyklu jest **efektywny** bieżący tryb (nadpisanie sesji przechodzące do domyślnej konfiguracji, gdy jest nieustawione), więc cykl jest zawsze spójny z tym, co użytkownik widzi w stopce. ### Konfiguracja Bez konfiguracji zachowanie pozostaje wcześniejsze (stopka wyłączona do czasu `/usage`). Użyj `/usage reset`, aby wyczyścić nadpisanie sesji i ponownie odziedziczyć skonfigurowaną wartość domyślną. ## Niestandardowa stopka `/usage full` `/usage full` pokazuje wbudowaną kompaktową stopkę z modelem, reasoning, trybem szybkim/wolnym, oknem kontekstu i kosztem, gdy te pola są dostępne. Pola tokenów i pamięci podręcznej pozostają dostępne dla niestandardowych szablonów. Plik szablonu nie jest wymagany. `messages.usageTemplate` służy tylko do zaawansowanych niestandardowych układów. Wartością jest ścieżka do pliku JSON (obsługuje `~`) albo obiekt inline, i gdy jest poprawna, zastępuje wbudowaną stopkę: ```json { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` Brakujące albo puste szablony po cichu wracają do wbudowanej stopki. Nieczytelne albo nieprawidłowe skonfigurowane szablony również wracają do wbudowanej stopki i emitują ostrzeżenie operatora. Zacznij niestandardowe szablony od wbudowanego kształtu, a następnie edytuj części, które chcesz zmienić: ```jsonc { "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}" }, ], }, }, } ``` ### Kształt ```jsonc { "schema": "openclaw.usageBar.v1", "scales": { "": "low-to-high glyphs" }, // string (1 glyph/char) or array "aliases": { "": { "": "