--- read_when: - Integrujesz interfejsy wykorzystania i limitów dostawcy - Musisz wyjaśnić sposób działania śledzenia użycia lub wymagania dotyczące uwierzytelniania summary: Mechanizmy monitorowania użycia i wymagania dotyczące danych uwierzytelniających title: Śledzenie użycia x-i18n: generated_at: "2026-07-12T15:06:00Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: c413dcbe838d94c57ba3f6ef9609331e139de6d0abbdb3860753a519bd490314 source_path: concepts/usage-tracking.md workflow: 16 --- ## Co to jest - Pobiera dane o użyciu i limitach bezpośrednio z punktu końcowego użycia każdego dostawcy. Bez szacowania opłat dostawcy; wyłącznie zgłaszane przez dostawcę nazwy planów, okna limitów, salda, wydatki, budżety, dzienna historia kosztów, przypisanie tokenów i modeli lub podsumowania stanu konta. - Czytelne dla człowieka dane wyjściowe okna limitu są normalizowane do postaci `X% pozostało`, nawet gdy dostawca zgłasza wykorzystany limit, pozostały limit albo tylko nieprzetworzone liczby. W przypadku dostawców bez resetowalnych okien limitów zamiast tego wyświetlany jest tekst podsumowania dostawcy (na przykład saldo). - Polecenie `/status` na poziomie sesji i narzędzie `session_status` korzystają awaryjnie z dziennika transkrypcji sesji, gdy bieżąca migawka sesji nie zawiera danych o tokenach lub modelu. To zachowanie uzupełnia brakujące liczniki tokenów i pamięci podręcznej, może odzyskać etykietę aktywnego modelu środowiska uruchomieniowego oraz preferuje większą sumę zorientowaną na prompt, gdy metadane sesji są niedostępne lub zawierają mniejszą wartość (`totalTokensFresh !== true`, zero albo wartość niższą niż wyprowadzona z transkrypcji). Niezerowe wartości bieżące zawsze mają pierwszeństwo przed danymi awaryjnymi. ## Gdzie się pojawia - `/status` w czatach: karta stanu z tokenami sesji i szacowanym kosztem (tylko modele używające klucza API). Gdy dane są dostępne, użycie dostawcy jest wyświetlane dla **dostawcy bieżącego modelu** jako znormalizowane okno `X% pozostało` lub tekst podsumowania dostawcy. - `/usage off|tokens|full` w czatach: stopka użycia dla każdej odpowiedzi. - `/usage cost` w czatach: lokalne podsumowanie kosztów zagregowane z dzienników sesji OpenClaw. - CLI: `openclaw status --usage` wyświetla pełne zestawienie użycia i limitów dla poszczególnych dostawców. - CLI: `openclaw models status` wyświetla profile uwierzytelniania OAuth/tokenem oraz podsumowanie okna użycia obok każdego dostawcy, który je udostępnia. - Interfejs sterowania: **Użycie** wyświetla karty planu i rozliczeń dostawcy nad analizą tokenów i szacowanych kosztów OpenClaw, wyprowadzoną z sesji. Dane uwierzytelniające interfejsów Anthropic i OpenAI Admin API dodają zgłaszane przez dostawcę wydatki z dzisiaj, 7 i 30 dni, dzienne trendy, sumy tokenów, najczęściej używane modele oraz kategorie kosztów. - Interfejs sterowania: wyskakujące okno pierścienia kontekstu w polu tworzenia wiadomości wyświetla **użycie planu** dla dostawców subskrypcyjnych — paski poszczególnych okien (5-godzinnych, tygodniowych i ograniczonych do modelu) z czasami resetowania, plan dostawcy, jeśli jest znany (na przykład `Max (20x)`), oraz środki na dodatkowe użycie. Sesje rozliczane w ramach planu ukrywają kwotowe oszacowania kosztu poszczególnych tokenów; sesje rozliczane przez API zachowują `Szac. koszt` i zestawienie kosztów według typu. Konfiguracje Claude Code CLI (`claude-cli`) korzystają z tych samych danych użycia subskrypcji Anthropic. - Pasek menu systemu macOS: główna sekcja „Użycie” pojawia się pod sekcją Kontekst, gdy dostępne są migawki użycia dostawcy. Zobacz [Pasek menu](/pl/platforms/mac/menu-bar). Polecenie `openclaw channels list` nie wyświetla już użycia dostawcy; zamiast tego kieruje użytkowników do `openclaw status` lub `openclaw models list`. ## Historia kosztów Anthropic i OpenAI Limit subskrypcji i rozliczenia API to odrębne obszary dostawcy: - Dane uwierzytelniające subskrypcji lub konfiguracji Anthropic nadal wyświetlają okna limitów Claude i opcjonalne budżety dodatkowego użycia. Ustaw `ANTHROPIC_ADMIN_KEY` lub `ANTHROPIC_ADMIN_API_KEY`, aby zamiast tego wyświetlać historię interfejsów Usage API i Cost API organizacji. Dane uwierzytelniające dostawcy Anthropic zaczynające się od `sk-ant-admin` są wykrywane automatycznie. - OAuth OpenAI ChatGPT/Codex nadal wyświetla plan, okna limitów i saldo środków. Ustaw `OPENAI_ADMIN_KEY`, aby zamiast tego wyświetlać historię kosztów i użycia uzupełnień w organizacji; opcjonalnie ustaw `OPENAI_PROJECT_ID`, aby ograniczyć zakres do jednego projektu. OpenClaw nigdy nie wysyła danych uwierzytelniających wnioskowania z `OPENAI_API_KEY`, konfiguracji dostawcy ani profili uwierzytelniania do interfejsów API organizacji, ponieważ klucze te mogą należeć do niestandardowych punktów końcowych. Dane uwierzytelniające administratora mają pierwszeństwo, ponieważ zapewniają rzeczywiste dane rozliczeniowe organizacji. OpenClaw nie łączy tych sum zgłaszanych przez dostawcę z lokalnymi oszacowaniami sesji; obie sekcje celowo odpowiadają na inne pytania. ## Domyślny tryb stopki użycia Polecenie `/usage off|tokens|full` ustawia stopkę sesji, a wybór jest zapamiętywany dla tej sesji. `messages.responseUsage` ustawia początkową wartość tego trybu dla sesji, które jeszcze go nie wybrały, dzięki czemu stopka może być domyślnie włączona bez każdorazowego wpisywania `/usage`. Ustaw jeden tryb dla wszystkich kanałów albo mapę dla poszczególnych kanałów z wartością rezerwową `default`: ```jsonc { "messages": { "responseUsage": "tokens", // lub: { "default": "off", "discord": "full" } }, } ``` Akceptowane wartości: `"off"`, `"tokens"`, `"full"` oraz starszy alias `"on"` (traktowany jako `"tokens"`). ### Trzy odrębne stany sesji Pole `responseUsage` sesji może reprezentować trzy stany, z których każdy ma inną semantykę: | Stan | Przechowywana wartość | Obowiązujący tryb | | ------------------------------ | -------------------------------- | ------------------------------------------------------------------------------ | | **Nieustawiony / dziedziczony** | `undefined` (brak) | Przechodzi do domyślnej konfiguracji `messages.responseUsage`, a następnie `off`. | | **Jawnie wyłączony** | `"off"` (przechowywane) | Zawsze wyłączony; konfiguracja domyślna inna niż `off` nie może ponownie włączyć stopki. | | **Jawnie włączony** | `"tokens"` lub `"full"` (przechowywane) | Ten tryb, niezależnie od konfiguracji domyślnej. | ### Pierwszeństwo Obowiązujący tryb = nadpisanie sesji → wpis konfiguracji kanału → `default` → `off`. Jawne `/usage off` jest **utrwalane** w sesji jako dosłowna wartość `"off"`, co nie jest tym samym co „nieustawione”. Domyślna wartość `messages.responseUsage` inna niż `off` nie może ponownie włączyć stopki po jej jawnym wyłączeniu przez użytkownika. ### Resetowanie a wyłączanie - `/usage off` wymusza wyłączenie stopki i utrwala ten wybór. Skonfigurowana domyślna wartość inna niż `off` nie może go nadpisać. - `/usage reset` (aliasy: `default`, `inherit`, `inherited`, `clear`, `unpin`) usuwa nadpisanie sesji. Sesja następnie **dziedziczy** obowiązującą konfigurację domyślną (`messages.responseUsage`). Jeśli nie skonfigurowano wartości domyślnej, stopka pozostaje wyłączona. - Pełny reset sesji (`/reset` lub `/new`) albo przejście do kolejnej sesji **zachowuje** jawną preferencję trybu użycia, dzięki czemu wybór sposobu wyświetlania dokonany przez użytkownika przetrwa przejścia między sesjami. Tylko `/usage reset` (i jego aliasy) usuwa nadpisanie. ### Działanie przełącznika Polecenie `/usage` bez argumentów przełącza cyklicznie: off → tokens → full → off. Punktem początkowym cyklu jest **obowiązujący** bieżący tryb (nadpisanie sesji, a jeśli go nie ustawiono — domyślna konfiguracja), dlatego cykl zawsze odpowiada temu, co użytkownik aktualnie widzi w stopce. ### Konfiguracja Bez konfiguracji zachowane zostaje wcześniejsze działanie (stopka jest wyłączona do czasu użycia `/usage`). Użyj `/usage reset`, aby usunąć nadpisanie sesji i ponownie odziedziczyć skonfigurowaną wartość domyślną. ## Niestandardowa stopka `/usage full` Polecenie `/usage tokens` zawsze renderuje zwykły wiersz `Użycie: X wejściowych / Y wyjściowych` (uzupełniony o informacje o pamięci podręcznej i szacowanym koszcie, gdy są dostępne). Tylko `/usage full` renderuje bogatszą stopkę opisaną poniżej. Polecenie `/usage full` wyświetla wbudowaną, zwartą stopkę z modelem, trybem rozumowania, trybem szybkim/wolnym, oknem kontekstu i kosztem, gdy te pola są dostępne. Wbudowana stopka nie wymaga pliku szablonu. `messages.usageTemplate` służy wyłącznie do zaawansowanych, niestandardowych układów. Wartością jest ścieżka do pliku JSON (obsługuje `~`) albo obiekt osadzony bezpośrednio; poprawna wartość zastępuje wbudowaną stopkę. Ścieżka pliku jest monitorowana, a zmiany są wczytywane na bieżąco. ```json { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` Brakujące lub puste szablony po cichu przełączają się na wbudowaną stopkę. Nieczytelne lub nieprawidłowo skonfigurowane szablony (błędny JSON albo struktura bez możliwych do wyrenderowania elementów wyjściowych) również przełączają się na wbudowaną stopkę i generują ostrzeżenie dla operatora. Tworzenie niestandardowych szablonów zacznij od wbudowanej struktury, a następnie zmodyfikuj wybrane części: ```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": " | 📚[{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}" }, ], }, }, } ``` ### Struktura ```jsonc { "schema": "openclaw.usageBar.v1", "scales": { "": "low-to-high glyphs" }, // ciąg znaków (1 glif/znak) albo tablica "aliases": { "": { "": "