Anthropic

Anthropic tworzy rodzinę modeli Claude. OpenClaw obsługuje dwie ścieżki uwierzytelniania:

• Klucz API — bezpośredni dostęp do API Anthropic z rozliczaniem według użycia (modele anthropic/*)
• Claude CLI — ponowne użycie istniejącego logowania Claude Code na tym samym hoście

Pierwsze kroki

openclaw onboard# choose: Anthropic API key

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

openclaw models list --provider anthropic

{  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}

claude --version

openclaw onboard# choose: Claude CLI

openclaw models list --provider anthropic

{  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-8" },      models: {        "anthropic/claude-opus-4-8": {          agentRuntime: { id: "claude-cli" },        },      },    },  },}

Domyślne ustawienia myślenia (Claude Fable 5, 4.8 i 4.6)

anthropic/claude-fable-5 zawsze używa adaptacyjnego myślenia i domyślnie ma wysiłek high. Ponieważ Anthropic nie pozwala wyłączyć myślenia dla tego modelu, /think off i /think minimal używają wysiłku low. OpenClaw pomija także niestandardowe wartości temperatury dla żądań Fable 5.

Claude Opus 4.8 domyślnie utrzymuje myślenie wyłączone w OpenClaw. Gdy jawnie włączysz adaptacyjne myślenie za pomocą /think high|xhigh|max, OpenClaw wysyła wartości wysiłku Opus 4.8 od Anthropic; modele Claude 4.6 domyślnie używają adaptive.

Nadpisz dla pojedynczej wiadomości za pomocą /think:<level> albo w parametrach modelu:

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-8": {          params: { thinking: "high" },        },      },    },  },}

Zapasowa obsługa odmowy ze względów bezpieczeństwa (Claude Fable 5)

Dlaczego to istnieje

Klasyfikatory Fable 5 zwracają stop_reason: "refusal" dla żądań w ograniczonych domenach, a także generują fałszywe alarmy przy pracy bliskiej dopuszczalnej (narzędzia bezpieczeństwa, nauki przyrodnicze, a nawet prośby do modelu o odtworzenie jego surowego rozumowania). Bez mechanizmu zapasowego tura kończy się błędem, mimo że inny model Claude chętnie by ją obsłużył — własny komunikat odmowy Anthropic instruuje integratorów API, aby skonfigurowali model zapasowy.

Jak to działa

1. Dla każdego bezpośredniego żądania z kluczem API do anthropic/claude-fable-5 OpenClaw wysyła zgodę na mechanizm zapasowy po stronie serwera Anthropic: nagłówek beta server-side-fallback-2026-06-01 oraz fallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 jest jedynym celem zapasowym, na który Anthropic zezwala dla Fable 5.
2. Mechanizm zapasowy uruchamia wyłącznie odmowa klasyfikatora bezpieczeństwa. Limity szybkości, przeciążenia i błędy serwera zachowują się dokładnie jak wcześniej i przechodzą przez normalne przełączanie awaryjne modelu OpenClaw.
3. Ratowanie odbywa się wewnątrz tego samego wywołania. Odmowa przed jakimkolwiek wyjściem jest niewidoczna poza opóźnieniem; cała odpowiedź pochodzi z Opus 4.8. Przy odmowie w środku strumienia częściowy tekst jest zachowywany jako prefiks, od którego kontynuuje model zapasowy, natomiast rozumowanie i wywołania narzędzi odrzuconego modelu są odrzucane zgodnie z regułami odtwarzania Anthropic (nie wolno ich odsyłać ani wykonywać).
4. Jeśli Claude Opus 4.8 również odmówi, tura pokazuje odmowę jako błąd, dokładnie tak jak przed tą funkcją.

Mechanizm zapasowy działa na poziomie API Anthropic, więc claude-opus-4-8 nie musi znajdować się na skonfigurowanej liście modeli ani w łańcuchu zapasowym — klucz API obsługujący Fable zawsze może obsłużyć Opus.

Obserwowalność i rozliczenia

• Tura obsłużona przez mechanizm zapasowy zapisuje diagnostykę provider_fallback w wiadomości asystenta, nazywając fromModel i toModel, a pole responseModel wiadomości zgłasza claude-opus-4-8.
• Anthropic rozlicza za próbę: odmowa przed wyjściem jest bezpłatna, a ratowanie jest rozliczane według stawek Claude Opus 4.8 (obecnie połowa stawek Fable 5). Szacunek kosztu na turę w OpenClaw wycenia tury obsłużone mechanizmem zapasowym według stawek Opus, aby to dopasować.
• Odmowa w środku strumienia dodatkowo rozlicza już przesłaną częściową odpowiedź Fable po stronie Anthropic; ta część jest raportowana w użyciu na próbę w API, ale nie jest wliczana do szacunku kosztu na turę w OpenClaw.

Zakres

Dotyczy anthropic/claude-fable-5 z uwierzytelnianiem kluczem API wobec api.anthropic.com. OAuth (ponowne użycie subskrypcji Claude CLI), bazowe adresy URL proxy, żądania Bedrock, Vertex i Foundry pozostają bez zmian i nadal pokazują odmowy jako błędy.

Zweryfikowano na żywo: łagodny prompt proszący Fable 5 o odtworzenie surowego łańcucha myśli jest odrzucany z category: "reasoning_extraction", gdy zostanie wysłany bez mechanizmów zapasowych, a ten sam prompt przez OpenClaw zwraca normalną odpowiedź obsłużoną przez Opus z dołączoną diagnostyką provider_fallback.

Zobacz przewodnik po odmowach i mechanizmach zapasowych Anthropic, aby poznać bazowe zachowanie.

Buforowanie promptów

OpenClaw obsługuje funkcję buforowania promptów Anthropic dla uwierzytelniania kluczem API.

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },  },}

{  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-6" },      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },    list: [      { id: "research", default: true },      { id: "alerts", params: { cacheRetention: "none" } },    ],  },}

Konfiguracja zaawansowana

{  agents: {    defaults: {      models: {        "anthropic/claude-sonnet-4-6": {          params: { fastMode: true },        },      },    },  },}

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {},      },    },  },}

Rozwiązywanie problemów

Powiązane