- Klucz API — bezpośredni dostęp do API Anthropic z rozliczeniem na podstawie użycia (modele
anthropic/*) - Claude CLI — ponowne użycie istniejącego logowania Claude Code na tym samym hoście
Śledzenie użycia i kosztów
OpenClaw wykrywa dostępne dane uwierzytelniające Anthropic i wybiera odpowiedni sposób prezentowania użycia:- Dane uwierzytelniające subskrypcji/konfiguracji Claude pokazują okresy limitów oraz opcjonalny budżet dodatkowego użycia.
ANTHROPIC_ADMIN_KEYlubANTHROPIC_ADMIN_API_KEYpokazuje w interfejsie Control UI w sekcji Użycie zgłoszone przez dostawcę koszty organizacji i użycie Messages API z ostatnich 30 dni, w tym dzienne wydatki, sumy tokenów/pamięci podręcznej, najczęściej używane modele i kategorie kosztów.- Dane uwierzytelniające
sk-ant-admin...zapisane w profilu dostawcy Anthropic są automatycznie wykrywane jako klucz Admin API.
Pierwsze kroki
- Klucz API
- Claude CLI
Najlepsze zastosowanie: standardowy dostęp do API i rozliczanie na podstawie użycia.Można też przekazać klucz bezpośrednio:
1
Uzyskanie klucza API
Utwórz klucz API w konsoli Anthropic.
2
Uruchomienie wdrażania
3
Sprawdzenie dostępności modelu
Przykład konfiguracji
Sesje Claude na różnych komputerach
Dołączony Plugin Anthropic dodaje grupę Claude Code do standardowego paska bocznego sesji. Wiersze otwierają się w standardowym panelu czatu. Plugin wykrywa niezarchiwizowane sesje Claude Code na Gateway i połączonych hostach Node:- Sesje Claude CLI pochodzą z prawidłowych rekordów indeksu projektów i bieżących plików JSONL,
których ograniczony prefiks metadanych identyfikuje sesję
sdk-cliniebędącą łańcuchem pobocznym w katalogu~/.claude/projects/. - Sesje Claude Desktop używają tytułu z aplikacji Desktop, czasu aktywności i stanu archiwizacji, gdy ich metadane wskazują ten sam identyfikator sesji Claude Code.
- Sesja dostępna wyłącznie w CLI nie ma flagi archiwizacji, dlatego pozostaje widoczna, dopóki istnieje jej transkrypcja.
~/.claude/projects/.
Gdy te polecenia pojawią się po raz pierwszy, należy zatwierdzić uaktualnienie parowania Node.
Pasek boczny grupuje wiersze według hosta Gateway lub sparowanego hosta Node, zaczyna od
najnowszej ograniczonej strony z każdego hosta i odświeża dane w standardowym
30-sekundowym cyklu. Opcja Wczytaj więcej sesji pod grupą katalogu dołącza następną stronę
z każdego hosta, który ma dalszą historię; dołączone wiersze pozostają widoczne i są
ponownie pobierane do tej samej głębokości podczas odświeżania. Klienci katalogu używają
sessions.catalog.list; otwarcie wiersza używa sessions.catalog.read.
Przejęcie terminala rozpoznaje claude na podstawie PATH powłoki logowania użytkownika hosta będącego właścicielem
przed PATH usługi/demona. Dzięki temu sesje uruchamiane przez aplikację pozostają zgodne
z Claude CLI dostępnym dla operatora w zwykłym terminalu.
Po wybraniu wiersza najpierw odczytywana jest najnowsza strona transkrypcji. Opcja Wczytaj starsze
elementy transkrypcji korzysta z nieprzezroczystego kursora bajtowego i odczytuje kolejną ograniczoną sekcję
pliku JSONL zamiast wczytywać całą historię. Zachowywana jest standardowa zawartość użytkownika, asystenta,
rozumowania, wywołań narzędzi i wyników narzędzi. Pojedynczy element
większy niż bezpieczny limit Node/Gateway jest wyraźnie oznaczany jako obcięty.
W przypadku lokalnego dla Gateway wiersza claude-cli wpisanie treści w standardowym polu tworzenia wiadomości wywołuje
sessions.catalog.continue. OpenClaw ponownie rozpoznaje lokalny rekord katalogu,
tworzy lub ponownie wykorzystuje natywną sesję z zablokowanym modelem, importuje maksymalnie 200 widocznych
elementów lub 512 KiB i inicjuje powiązanie Claude CLI. Pierwsza tura jest wznawiana za pomocą
--fork-session; Claude przypisuje rozwidleniu nowy identyfikator sesji, dlatego kolejne tury używają
rozwidlenia, a sesja źródłowa pozostaje niezmieniona.
Host Node bez interfejsu graficznego może również umożliwić kontynuowanie swoich wierszy Claude CLI przez włączenie
poniższego ustawienia lokalnego dla Node i ponowne uruchomienie hosta Node:
agent.cli.claude.run.v1 tylko wtedy, gdy ustawienie jest włączone,
a lokalny plik wykonywalny claude zostanie odnaleziony. OpenClaw ponownie rozpoznaje rekord katalogu
na tym Node, importuje tę samą ograniczoną historię i wiąże przejętą
sesję z Node oraz katalogiem roboczym zgłoszonym przez katalog. Każda tura uruchamia
rzeczywisty proces claude -p tego Node, korzystając z jego plików Claude i logowania. Zasady
zatwierdzania wykonywania poleceń na Node nadal obowiązują; Gateway nie może wymusić zgody.
Kontynuacja na Node w wersji v1 jest wyłącznie jednorazowa. Pomija konfigurację MCP pętli zwrotnej Gateway i
argumenty Pluginu Skills Gateway, nie inicjuje ponownie danych z transkrypcji Gateway oraz
odrzuca załączniki i obrazy. Wiersze Claude Desktop pozostają tylko do odczytu. Natywne
Node aplikacji macOS również pozostają tylko do odczytu, dopóki aplikacja nie udostępni polecenia uruchamiania.
Sesje Claude na sparowanym Node pozostają tylko do odczytu, chyba że Node bez interfejsu graficznego jawnie
udostępnia
agent.cli.claude.run.v1. OpenClaw nigdy nie modyfikuje metadanych Claude Desktop
ani nie archiwizuje sesji Claude. Strona wymaga połączenia operatora
z zakresem zapisu, ponieważ używa uwierzytelnionego node.invoke; operacje wyświetlania listy i odczytu
pozostają tylko do odczytu nawet na Node z włączoną kontynuacją.Domyślne ustawienia rozumowania (Claude Sonnet 5, Mythos 5, Fable 5, 4.8 i 4.6)
anthropic/claude-sonnet-5 domyślnie korzysta z adaptacyjnego myślenia przy poziomie wysiłku high.
Użyj /think off, aby wyłączyć myślenie, lub /think xhigh|max, aby ustawić
wyższe natywne poziomy wysiłku modelu. OpenClaw pomija ręczne budżety myślenia, niestandardowe
parametry próbkowania, wstępne uzupełnienia asystenta oraz Priority Tier dla Sonnet 5, ponieważ
Anthropic nie obsługuje tych funkcji żądań w tym modelu.
Katalog stosuje promocyjne ceny Anthropic $2/$10 za dane wejściowe/wyjściowe do
31 sierpnia 2026 r.; standardowe ceny $3/$15 zaczynają obowiązywać 1 września 2026 r.
anthropic/claude-fable-5 zawsze korzysta z adaptacyjnego myślenia i domyślnie stosuje poziom
wysiłku high. Anthropic nie pozwala wyłączyć myślenia w tym modelu, dlatego
/think off i /think minimal są zamiast tego mapowane na poziom wysiłku low. OpenClaw
pomija również niestandardowe wartości temperatury w żądaniach Fable 5, ponieważ Anthropic odrzuca
nadpisanie temperatury w każdym żądaniu z włączonym myśleniem.
anthropic/claude-mythos-5 jest modelem o ograniczonym dostępie z takim samym kontraktem
stale włączonego adaptacyjnego myślenia. OpenClaw domyślnie stosuje high, mapuje /think off i
/think minimal na low oraz pomija parametry próbkowania wybrane przez wywołującego.
Katalog podaje okno kontekstu wynoszące 1 000 000 tokenów, limit danych wyjściowych
wynoszący 128 000 tokenów, obsługę obrazów na wejściu oraz ceny $10/$50 za dane wejściowe/wyjściowe.
W OpenClaw myślenie w Claude Opus 4.8 jest domyślnie wyłączone. Gdy jawnie
włączysz adaptacyjne myślenie za pomocą /think high|xhigh|max, OpenClaw wysyła
wartości wysiłku Anthropic dla Opus 4.8; modele Claude 4.6 (Opus 4.6 i Sonnet 4.6)
domyślnie stosują adaptive.
Nadpisz ustawienie dla pojedynczej wiadomości za pomocą /think:<level> lub w parametrach modelu:
Powiązana dokumentacja Anthropic:
Mechanizm rezerwowy w przypadku odmowy ze względów bezpieczeństwa (Claude Fable 5)
Dlaczego ten mechanizm istnieje
Klasyfikatory Fable 5 zwracająstop_reason: "refusal" dla żądań w obszarach
objętych ograniczeniami, a także generują fałszywie dodatnie wyniki w przypadku nieszkodliwych, pokrewnych zadań (narzędzia
bezpieczeństwa, nauki biologiczne, a nawet prośba o odtworzenie przez model jego surowego
toku rozumowania). Bez mechanizmu rezerwowego interakcja kończy się błędem, mimo że
inny model Claude mógłby ją bez problemu obsłużyć — komunikat Anthropic o odmowie
zaleca integratorom API skonfigurowanie modelu rezerwowego.
Jak to działa
- W każdym bezpośrednim żądaniu z kluczem API do
anthropic/claude-fable-5OpenClaw wysyła zgodę na użycie mechanizmu rezerwowego po stronie serwera Anthropic: nagłówek betaserver-side-fallback-2026-06-01orazfallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 jest jedynym modelem rezerwowym, na który Anthropic zezwala w przypadku Fable 5. - Mechanizm rezerwowy jest uruchamiany wyłącznie przez odmowę klasyfikatora bezpieczeństwa. Limity szybkości, przeciążenia i błędy serwera zachowują się dokładnie tak jak wcześniej i są obsługiwane przez standardowy mechanizm przełączania awaryjnego modeli w OpenClaw.
- Obsługa rezerwowa odbywa się w ramach tego samego wywołania. Odmowa przed wygenerowaniem jakichkolwiek danych wyjściowych jest niezauważalna poza opóźnieniem; cała odpowiedź pochodzi z Opus 4.8. W przypadku odmowy w trakcie strumieniowania częściowy tekst jest zachowywany jako prefiks, od którego model rezerwowy kontynuuje odpowiedź, natomiast rozumowanie i wywołania narzędzi odrzuconego modelu są usuwane zgodnie z regułami odtwarzania Anthropic (nie wolno ich zwracać ani wykonywać).
- Jeśli Claude Opus 4.8 również odmówi, odmowa zostanie zwrócona jako błąd, dokładnie tak jak przed wprowadzeniem tej funkcji.
claude-opus-4-8 nie musi
znajdować się na skonfigurowanej liście modeli ani w łańcuchu rezerwowym — klucz API
obsługujący Fable zawsze może obsłużyć Opus.
Obserwowalność i rozliczenia
- Interakcja obsłużona przez model rezerwowy zapisuje diagnostykę
provider_fallbackw wiadomości asystenta, wskazującąfromModelitoModel, a poleresponseModelwiadomości zgłaszaclaude-opus-4-8. - Anthropic nalicza opłaty za każdą próbę: odmowa przed wygenerowaniem danych wyjściowych jest bezpłatna, a obsługa rezerwowa jest rozliczana według stawek Claude Opus 4.8 (obecnie stanowiących połowę stawek Fable 5). OpenClaw wycenia koszt interakcji obsłużonych przez model rezerwowy według stawek Opus, aby zachować zgodność.
- Odmowa w trakcie strumieniowania powoduje dodatkowo naliczenie przez Anthropic opłat za już przesłaną strumieniowo część odpowiedzi Fable; ta część jest wykazywana w użyciu dla poszczególnych prób w API, ale nie jest uwzględniana w szacowanym przez OpenClaw koszcie interakcji.
Zakres
Dotyczyanthropic/claude-fable-5 z uwierzytelnianiem za pomocą klucza API względem
api.anthropic.com. OAuth (ponowne wykorzystanie subskrypcji Claude CLI), bazowe adresy URL serwerów proxy,
żądania Bedrock, Vertex i Foundry pozostają bez zmian i nadal zwracają
odmowy jako błędy.
Zweryfikowano na żywo: nieszkodliwa prośba o odtworzenie przez Fable 5 jego surowego toku
rozumowania jest odrzucana z kodem category: "reasoning_extraction", gdy zostanie wysłana bez
mechanizmów rezerwowych, natomiast ta sama prośba przesłana przez OpenClaw zwraca zwykłą odpowiedź
obsłużoną przez Opus z dołączoną diagnostyką provider_fallback.
Podstawowe działanie opisano w przewodniku Anthropic dotyczącym odmów i mechanizmów
rezerwowych.
Buforowanie promptów
OpenClaw obsługuje funkcję buforowania promptów Anthropic w przypadku uwierzytelniania za pomocą klucza API.Nadpisywanie pamięci podręcznej dla poszczególnych agentów
Nadpisywanie pamięci podręcznej dla poszczególnych agentów
Użyj parametrów na poziomie modelu jako ustawień bazowych, a następnie nadpisz je dla określonych agentów za pomocą Kolejność scalania konfiguracji:
agents.list[].params:agents.defaults.models["provider/model"].paramsagents.list[].params(pasujące doid, zastępują według klucza)
Uwagi dotyczące Claude w Bedrock
Uwagi dotyczące Claude w Bedrock
- Modele Anthropic Claude w Bedrock (
amazon-bedrock/*anthropic.claude*) akceptują przekazywaniecacheRetention, gdy jest skonfigurowane. - Modele Bedrock inne niż Anthropic są podczas działania wymuszane na
cacheRetention: "none". - Inteligentne wartości domyślne klucza API ustawiają również
cacheRetention: "short"dla odwołań do Claude w Bedrock, gdy nie ustawiono jawnej wartości.
Konfiguracja zaawansowana
Tryb szybki
Tryb szybki
Wspólny przełącznik
/fast OpenClaw ustawia pole service_tier Anthropic dla bezpośredniego ruchu uwierzytelnianego kluczem API na api.anthropic.com.- Dotyczy wyłącznie bezpośrednich żądań
api.anthropic.comwykonywanych przy użyciu klucza API. Żądania z tokenem OAuth/subskrypcji i trasy proxy nigdy nie otrzymują polaservice_tier. - Jawne parametry
serviceTierlubservice_tierzastępują/fast, gdy ustawiono oba. - Na kontach bez dostępnej pojemności Priority Tier wartość
service_tier: "auto"może zostać rozstrzygnięta jakostandard.
Rozumienie multimediów (obrazy i pliki PDF)
Rozumienie multimediów (obrazy i pliki PDF)
Dołączony Plugin Anthropic rejestruje rozumienie obrazów i plików PDF. OpenClaw
automatycznie określa możliwości obsługi multimediów na podstawie skonfigurowanego uwierzytelniania Anthropic;
dodatkowa konfiguracja nie jest wymagana.
Po dołączeniu obrazu lub pliku PDF do rozmowy OpenClaw automatycznie
kieruje go przez dostawcę rozumienia multimediów Anthropic.
Okno kontekstu 1M
Okno kontekstu 1M
Claude Sonnet 5, Mythos 5 i Fable 5 mają okno wejściowe o dokładnym rozmiarze
1 000 000 tokenów i obsługują do 128 000 tokenów wyjściowych. Okno kontekstu
1M Anthropic jest również ogólnie dostępne w modelach Claude 4.x z myśleniem adaptacyjnym: Opus 4.8,
Opus 4.7, Opus 4.6 i Sonnet 4.6. OpenClaw automatycznie dobiera rozmiar tych modeli;
Starsze konfiguracje mogą zachować
params.context1m nie jest potrzebne:params.context1m: true; jest to nieszkodliwa operacja bez efektu dla
tych modeli, a OpenClaw nie wysyła już wycofanego nagłówka beta
context-1m-2025-08-07 niezależnie od konfiguracji. Starsze wpisy konfiguracji anthropicBeta
z tą wartością są usuwane podczas rozstrzygania nagłówków żądania, a
nieobsługiwane starsze modele Claude zachowują standardowe okno kontekstu.params.context1m: true działa tak samo dla backendu Claude CLI
(claude-cli/*): kwalifikujące się modele Opus i Sonnet obsługujące ogólną dostępność już automatycznie otrzymują
okno 1M, więc ten parametr również jest tam opcjonalny.Kontekst 1M Claude Opus 4.8
Kontekst 1M Claude Opus 4.8
anthropic/claude-opus-4-8 i jego wariant claude-cli mają domyślnie okno kontekstu
1M; params.context1m: true nie jest potrzebne.Rozwiązywanie problemów
Błędy 401 / token nagle stał się nieprawidłowy
Błędy 401 / token nagle stał się nieprawidłowy
Uwierzytelnianie tokenem Anthropic wygasa i może zostać unieważnione. W nowych konfiguracjach należy zamiast niego używać klucza API Anthropic.
Nie znaleziono klucza API dla dostawcy „anthropic”
Nie znaleziono klucza API dla dostawcy „anthropic”
Uwierzytelnianie Anthropic jest konfigurowane dla każdego agenta osobno; nowi agenci nie dziedziczą kluczy głównego agenta. Należy ponownie uruchomić wdrażanie dla tego agenta (lub skonfigurować klucz API na hoście Gateway), a następnie zweryfikować za pomocą
openclaw models status.Nie znaleziono danych uwierzytelniających dla profilu „anthropic:default”
Nie znaleziono danych uwierzytelniających dla profilu „anthropic:default”
Uruchom
openclaw models status, aby sprawdzić, który profil uwierzytelniania jest aktywny. Ponownie uruchom wdrażanie lub skonfiguruj klucz API dla ścieżki tego profilu.Brak dostępnego profilu uwierzytelniania (wszystkie są w okresie oczekiwania)
Brak dostępnego profilu uwierzytelniania (wszystkie są w okresie oczekiwania)
Sprawdź
openclaw models status --json pod kątem auth.unusableProfiles. Okresy oczekiwania po przekroczeniu limitu żądań Anthropic mogą być przypisane do modelu, więc inny model Anthropic może nadal być dostępny. Dodaj kolejny profil Anthropic lub poczekaj na zakończenie okresu oczekiwania.Więcej pomocy: Rozwiązywanie problemów i Najczęściej zadawane pytania.
Powiązane
Wybór modelu
Wybieranie dostawców, odwołań do modeli i sposobu przełączania awaryjnego.
Backendy CLI
Konfiguracja backendu Claude CLI i szczegóły środowiska uruchomieniowego.
Buforowanie promptów
Jak działa buforowanie promptów u różnych dostawców.
OAuth i uwierzytelnianie
Szczegóły uwierzytelniania i zasady ponownego używania danych uwierzytelniających.