Użycie API i koszty

Mapa funkcji OpenClaw, które mogą wywoływać płatne interfejsy API dostawców, miejsc, z których każda z nich odczytuje dane uwierzytelniające, oraz miejsc, w których pojawiają się wynikające z tego koszty.

Gdzie pojawiają się koszty

/status (migawka dla sesji)

• Pokazuje bieżący model sesji, wykorzystanie kontekstu oraz tokeny ostatniej odpowiedzi.
• Dodaje szacowany koszt ostatniej odpowiedzi, gdy OpenClaw ma metadane użycia i lokalne informacje o cenach aktywnego modelu, w tym jawnie wycenionych dostawców niewymagających klucza API, takich jak modele Bedrock aws-sdk.
• Jeśli bieżąca migawka sesji zawiera niewiele danych, /status odzyskuje liczniki tokenów i pamięci podręcznej oraz etykietę aktywnego modelu z najnowszego wpisu użycia w transkrypcji. Istniejące niezerowe wartości bieżące mają pierwszeństwo przed danymi transkrypcji; suma z transkrypcji odpowiadająca rozmiarowi monitu może jednak mieć pierwszeństwo, gdy zapisana suma jest niedostępna lub mniejsza.

/usage (stopka każdej wiadomości)

• /usage full dołącza stopkę użycia do każdej odpowiedzi, w tym szacowany koszt, gdy skonfigurowano lokalne informacje o cenach i dostępne są metadane użycia.
• /usage tokens pokazuje tylko tokeny. Środowiska uruchomieniowe oparte na subskrypcji, OAuth/tokenie i CLI pokazują tylko tokeny, chyba że dostarczają zgodne metadane użycia oraz jawną cenę lokalną.
• /usage cost wyświetla lokalne podsumowanie kosztów; /usage off wyłącza stopkę.
• Uwaga dotycząca Gemini CLI: zarówno dane wyjściowe stream-json, jak i starsze json zawierają informacje o użyciu w polu stats. OpenClaw normalizuje stats.cached do cacheRead i w razie potrzeby wylicza tokeny wejściowe jako stats.input_tokens - stats.cached.

Interfejs sterowania → Użycie (analiza obejmująca wiele sesji)

• Pokazuje łączne liczby tokenów i szacowane koszty wyliczone z transkrypcji dla wybranego zakresu dat, z podziałem według dostawcy, modelu, agenta, kanału i typu tokena.
• Porównuje krótsze okresy kalendarzowe kończące się w dniu końcowym wybranego zakresu. Brakujące daty są liczone jako dni kalendarzowe o zerowym użyciu; nie są pomijane w celu utworzenia gęstszego okresu.
• Bezpośrednio opisuje skalę wykresu dziennego. Znacznik √ oznacza, że kompresja za pomocą pierwiastka kwadratowego zapewnia widoczność dni o niskim użyciu.
• Te sumy opisują dostępną lokalną historię sesji, a nie fakturę dostawcy ani rejestr rozliczeń z całego okresu użytkowania. Interfejs ostrzega, gdy dla niektórych wpisów brakuje informacji o cenach.

Okresy użycia w CLI (limity dostawców, nie koszt każdej wiadomości)

• Polecenia openclaw status --usage i openclaw channels list pokazują okresy użycia dostawców jako X% left.
• Obecni dostawcy okresów użycia: Anthropic, ClawRouter, DeepSeek, GitHub Copilot, Gemini CLI, MiniMax, OpenAI (obejmuje uwierzytelnianie ChatGPT/Codex przez OAuth/token), Xiaomi oraz z.ai. Pełna lista dostawców i flag znajduje się w sekcjach CLI modeli oraz CLI kanałów.
• Surowe pola usage_percent / usagePercent MiniMax wskazują pozostały limit, dlatego OpenClaw odwraca ich wartości; pola oparte na liczbie mają pierwszeństwo, gdy są dostępne. Jeśli odpowiedź zawiera tablicę model_remains, OpenClaw wybiera wpis modelu czatu, w razie potrzeby wylicza etykietę okresu na podstawie znaczników czasu i umieszcza nazwę modelu w etykiecie planu.
• Dane uwierzytelniające do sprawdzania użycia pochodzą ze specyficznych dla dostawcy punktów zaczepienia, jeśli są dostępne. W przeciwnym razie OpenClaw używa pasujących danych uwierzytelniających OAuth lub klucza API z profili uwierzytelniania, środowiska albo konfiguracji.

Szczegółowe przykłady znajdują się w sekcji Użycie tokenów i koszty.

Jak wykrywane są klucze

• Profile uwierzytelniania: osobne dla każdego agenta, przechowywane w auth-profiles.json.
• Zmienne środowiskowe: na przykład OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY.
• Konfiguracja: models.providers.*.apiKey, plugins.entries.*.config.webSearch.apiKey, plugins.entries.firecrawl.config.webFetch.apiKey, agents.defaults.memorySearch.*, talk.providers.*.apiKey.
• Skills: skills.entries.<name>.apiKey, które mogą eksportować klucz do środowiska procesu Skills.

Funkcje, które mogą zużywać środki powiązane z kluczami

Odpowiedzi głównego modelu (czat i narzędzia)

Każda odpowiedź lub każde wywołanie narzędzia działa za pośrednictwem bieżącego dostawcy modelu. Jest to główne źródło użycia i kosztów, w tym hostowanych planów subskrypcyjnych rozliczanych poza lokalnym interfejsem OpenClaw: OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan, Z.AI/GLM Coding Plan oraz ścieżki logowania Claude firmy Anthropic z włączoną opcją Extra Usage.

Informacje o konfiguracji cen znajdują się w sekcji Modele, a informacje o ich wyświetlaniu — w sekcji Użycie tokenów i koszty.

Analiza multimediów (dźwięk/obraz/wideo)

Przychodzące multimedia mogą zostać podsumowane lub poddane transkrypcji za pośrednictwem API dostawcy przed uruchomieniem potoku odpowiedzi. Obsługa dostawców jest rejestrowana osobno dla każdego pluginu i zmienia się wraz z dodawaniem pluginów; aktualną listę i konfigurację zawiera sekcja Analiza multimediów.

Generowanie obrazów i wideo

image_generate i video_generate kierują żądania do dowolnego dostępnego skonfigurowanego dostawcy. Generowanie obrazów może automatycznie wybrać domyślnego dostawcę na podstawie dostępnych danych uwierzytelniających, gdy agents.defaults.imageGenerationModel nie jest ustawione; generowanie wideo wymaga jawnego ustawienia agents.defaults.videoGenerationModel (na przykład qwen/wan2.6-t2v).

Aktualną listę dostawców zawierają sekcje Generowanie obrazów i Generowanie wideo.

Osadzanie pamięci i wyszukiwanie semantyczne

Semantyczne wyszukiwanie w pamięci korzysta z interfejsów API osadzania, gdy agents.defaults.memorySearch.provider wskazuje zdalny adapter (na przykład openai, gemini, voyage, mistral, deepinfra, github-copilot, amazon-bedrock). Ustawienie memorySearch.provider = "lmstudio" lub "ollama" korzysta z lokalnego lub samodzielnie hostowanego serwera i zazwyczaj nie wiąże się z opłatami za usługę hostowaną. Ustawienie memorySearch.provider = "local" wykonuje wszystko na urządzeniu bez użycia API. Opcjonalny dostawca memorySearch.fallback może obsługiwać awarie lokalnego osadzania.

Zobacz sekcję Pamięć.

Narzędzie wyszukiwania w internecie

web_search może powodować naliczanie opłat zależnie od wybranego dostawcy. Każdy dostawca odczytuje swój klucz najpierw ze zmiennej środowiskowej, a następnie z plugins.entries.<id>.config.webSearch.apiKey:

Starsze ścieżki konfiguracji tools.web.search.* nadal są wczytywane za pośrednictwem warstwy zgodności, ale nie są już zalecanym interfejsem.

Bezpłatny kredyt Brave Search: każdy plan obejmuje odnawiany co miesiąc bezpłatny kredyt w wysokości 5 USD. Plan Search kosztuje 5 USD za 1000 żądań, więc kredyt pokrywa bez opłat 1000 żądań miesięcznie. Ustaw limit użycia w panelu Brave, aby uniknąć nieoczekiwanych opłat.

Zobacz sekcję Narzędzia internetowe.

Narzędzie pobierania treści internetowych (Firecrawl)

web_fetch może wywoływać Firecrawl z bezkluczowym dostępem startowym; dodaj FIRECRAWL_API_KEY (lub plugins.entries.firecrawl.config.webFetch.apiKey), aby uzyskać wyższe limity. Jeśli Firecrawl nie jest skonfigurowany, narzędzie przechodzi na bezpośrednie pobieranie oraz dołączony plugin web-readability (bez płatnego API). Wyłącz plugins.entries.web-readability.enabled, aby pominąć lokalne wyodrębnianie za pomocą Readability.

Zobacz sekcję Narzędzia internetowe.

Migawki użycia dostawców (stan/kondycja)

Polecenia openclaw status --usage i openclaw models status --json wywołują punkty końcowe użycia dostawców, aby pokazać okresy limitów lub stan uwierzytelniania. Liczba wywołań jest niewielka, ale nadal trafiają one do interfejsów API dostawców.

Zobacz sekcję CLI modeli.

Podsumowywanie zabezpieczające podczas Compaction

Mechanizm zabezpieczający Compaction może podsumować historię sesji za pomocą bieżącego modelu, co podczas działania powoduje wywołanie interfejsów API dostawców.

Zobacz sekcję Zarządzanie sesją i Compaction.

Skanowanie / testowanie modelu

openclaw models scan może testować modele OpenRouter i używa OPENROUTER_API_KEY, gdy testowanie jest włączone.

Zobacz sekcję CLI modeli.

Rozmowa (mowa)

Tryb rozmowy może wywoływać ElevenLabs, gdy jest skonfigurowany: ELEVENLABS_API_KEY lub talk.providers.elevenlabs.apiKey.

Zobacz sekcję Tryb rozmowy.

Skills (interfejsy API innych firm)

Skills mogą przechowywać apiKey w skills.entries.<name>.apiKey. Jeśli Skills używa tego klucza do komunikacji z zewnętrznym API, koszt zależy od dostawcy Skills.

Zobacz sekcję Skills.

Powiązane

• Użycie tokenów i koszty
• Buforowanie monitów
• Śledzenie użycia