// dokumentacja openclaw

Śledzenie zużycia w OpenClaw — monitoring kosztów i tokenów

Przegląd

System śledzenia zużycia w OpenClaw pobiera informacje o zużyciu i kwotach bezpośrednio z endpointów providerów, zamiast szacować koszty. Wynik normalizowany jest do czytelnego „X% pozostało" niezależnie od formatu danych providera.

Główne funkcje

  • Pobieranie danych zużycia i kwot bezpośrednio z API providerów
  • Normalizacja statusu do jednolitego formatu „X% pozostało"
  • Fallback na poziomie sesji — gdy dane na żywo są skąpe, system bazuje na zużyciu z transkryptu

Gdzie wyświetlane są dane

Polecenie /status w czacie

Pokazuje sformatowany status z emoji, tokenami sesji i szacowanym kosztem. To najszybszy sposób na sprawdzenie bieżącego zużycia podczas rozmowy.

Polecenie /usage

Oferuje różne poziomy szczegółowości:

  • /usage off — wyłącz wyświetlanie
  • /usage tokens — pokaż tokeny
  • /usage full — pełne szczegóły
  • /usage cost — pokaż szacowany koszt

CLI

openclaw status --usage     # Status z danymi zużycia
openclaw channels list      # Podział per provider

Aplikacja macOS

Pasek menu wyświetla zużycie w sekcji Context, gdy dane są dostępne.

Wspierani providerzy i uwierzytelnianie

System integruje się z wieloma providerami AI:

  • Anthropic (Claude) — tokeny OAuth
  • GitHub Copilot — tokeny OAuth
  • Gemini CLI — tokeny OAuth z fallbackiem JSON na stats
  • OpenAI Codex — tokeny OAuth
  • MiniMax — klucz API lub OAuth; warianty minimax, minimax-cn, minimax-portal traktowane jako ujednolicona kwota
  • Xiaomi MiMo — klucz API ze zmiennej środowiskowej lub konfiguracji
  • Z.AI — klucz API ze zmiennej środowiskowej lub konfiguracji

Każdy provider ma specyficzne mapowania pól i logikę fallback do normalizacji danych zużycia do spójnego formatu.

Praktyczne wskazówki

Regularne sprawdzanie /status lub /usage cost pomaga kontrolować koszty, szczególnie przy długich sesjach lub intensywnym korzystaniu z narzędzi. Gdy dane na żywo nie są dostępne dla danego providera, system automatycznie kalkuluje zużycie na podstawie transkryptu sesji.