Providers

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 CLI na tym samym hoście

Pierwsze kroki

API key

Najlepsze do: standardowego dostępu API i rozliczania według użycia.

Get your API key

Utwórz klucz API w konsoli Anthropic.

Run onboarding

bash

openclaw onboard# choose: Anthropic API key

Albo przekaż klucz bezpośrednio:

bash

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

Verify the model is available

bash

openclaw models list --provider anthropic

Przykład konfiguracji

json5

{  env: { ANTHROPIC_API_KEY: "sk-ant-..." },  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },}

Claude CLI

Najlepsze do: ponownego użycia istniejącego logowania Claude CLI bez osobnego klucza API.

Ensure Claude CLI is installed and logged in

Zweryfikuj za pomocą:

bash

claude --version

Run onboarding

bash

openclaw onboard# choose: Claude CLI

OpenClaw wykrywa i ponownie używa istniejących poświadczeń Claude CLI.

Verify the model is available

bash

openclaw models list --provider anthropic

Przykład konfiguracji

Preferuj kanoniczne odwołanie do modelu Anthropic oraz nadpisanie środowiska wykonawczego CLI:

json5

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

Starsze odwołania do modeli claude-cli/claude-opus-4-7 nadal działają ze względu na zgodność, ale nowa konfiguracja powinna zachowywać wybór dostawcy/modelu jako anthropic/*, a backend wykonawczy umieszczać w polityce środowiska wykonawczego dostawcy/modelu.

Domyślne myślenie (Claude 4.6)

Modele Claude 4.6 domyślnie używają w OpenClaw myślenia adaptive, gdy nie ustawiono jawnego poziomu myślenia.

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

json5

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

Buforowanie promptów

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

Wartość	Czas trwania bufora	Opis
`"short"` (domyślnie)	5 minut	Stosowane automatycznie dla uwierzytelniania kluczem API
`"long"`	1 godzina	Rozszerzony bufor
`"none"`	Bez buforowania	Wyłącz buforowanie promptów

json5

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

Per-agent cache overrides

Użyj parametrów na poziomie modelu jako wartości bazowej, a następnie nadpisz konkretne agenty przez agents.list[].params:

json5

{  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" } },    ],  },}

Kolejność scalania konfiguracji:

agents.defaults.models["provider/model"].params
agents.list[].params (pasujące id, nadpisuje według klucza)

Dzięki temu jeden agent może utrzymywać długotrwały bufor, podczas gdy inny agent na tym samym modelu wyłącza buforowanie dla ruchu skokowego lub o niskim ponownym użyciu.

Bedrock Claude notes

Modele Anthropic Claude w Bedrock (amazon-bedrock/*anthropic.claude*) akceptują przekazanie cacheRetention, gdy jest skonfigurowane.
Modele Bedrock inne niż Anthropic są w czasie działania wymuszane na cacheRetention: "none".
Inteligentne wartości domyślne dla klucza API ustawiają też cacheRetention: "short" dla odwołań Claude-on-Bedrock, gdy nie ustawiono jawnej wartości.

Zaawansowana konfiguracja

Fast mode

Wspólny przełącznik /fast w OpenClaw obsługuje bezpośredni ruch Anthropic (klucz API i OAuth do api.anthropic.com).

Polecenie	Mapuje na
`/fast on`	`service_tier: "auto"`
`/fast off`	`service_tier: "standard_only"`

json5

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

Media understanding (image and PDF)

Dołączony Plugin Anthropic rejestruje rozumienie obrazów i PDF. OpenClaw automatycznie rozstrzyga możliwości multimediów na podstawie skonfigurowanego uwierzytelniania Anthropic — nie jest potrzebna żadna dodatkowa konfiguracja.

Właściwość	Wartość
Model domyślny	`claude-opus-4-7`
Obsługiwane wejście	Obrazy, dokumenty PDF

Gdy obraz lub PDF zostanie dołączony do rozmowy, OpenClaw automatycznie kieruje go przez dostawcę rozumienia multimediów Anthropic.

1M context window (beta)

Okno kontekstu 1M Anthropic jest objęte dostępem beta. Włącz je dla modelu:

json5

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

OpenClaw mapuje to w żądaniach na anthropic-beta: context-1m-2025-08-07.

params.context1m: true ma też zastosowanie do backendu Claude CLI (claude-cli/*) dla kwalifikujących się modeli Opus i Sonnet, rozszerzając okno kontekstu środowiska wykonawczego dla tych sesji CLI tak, aby odpowiadało zachowaniu bezpośredniego API.

Claude Opus 4.7 1M context

anthropic/claude-opus-4.7 oraz jego wariant claude-cli mają domyślnie okno kontekstu 1M — params.context1m: true nie jest potrzebne.

Rozwiązywanie problemów

401 errors / token suddenly invalid

Uwierzytelnianie tokenem Anthropic wygasa i może zostać unieważnione. W przypadku nowych konfiguracji użyj zamiast tego klucza API Anthropic.

No API key found for provider "anthropic"

Uwierzytelnianie Anthropic jest per agent — nowe agenty nie dziedziczą kluczy głównego agenta. Uruchom ponownie onboarding dla tego agenta (albo skonfiguruj klucz API na hoście gateway), a następnie zweryfikuj za pomocą openclaw models status.

No credentials found for profile "anthropic:default"

Uruchom openclaw models status, aby sprawdzić, który profil uwierzytelniania jest aktywny. Uruchom ponownie onboarding albo skonfiguruj klucz API dla ścieżki tego profilu.

No available auth profile (all in cooldown)

Sprawdź openclaw models status --json pod kątem auth.unusableProfiles. Okresy cooldown limitów szybkości Anthropic mogą być ograniczone do modelu, więc pokrewny model Anthropic może nadal być używalny. Dodaj kolejny profil Anthropic albo poczekaj na zakończenie cooldown.

Powiązane

Model selection

Wybór dostawców, odwołań do modeli i zachowania przełączania awaryjnego.

CLI backends

Szczegóły konfiguracji i działania backendu Claude CLI.

Prompt caching

Jak buforowanie promptów działa u różnych dostawców.

OAuth and auth

Szczegóły uwierzytelniania i reguły ponownego użycia poświadczeń.

Was this useful?