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

Klucz API

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

Uzyskaj klucz API

Utwórz klucz API w konsoli Anthropic.

Uruchom onboarding

openclaw onboard
# choose: Anthropic API key

Lub przekaż klucz bezpośrednio:

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

Zweryfikuj, czy model jest dostępny

openclaw models list --provider anthropic

Przykład konfiguracji

{
  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.

Upewnij się, że Claude CLI jest zainstalowany i zalogowany

Zweryfikuj za pomocą:

claude --version

Uruchom onboarding

openclaw onboard
# choose: Claude CLI

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

Zweryfikuj, czy model jest dostępny

openclaw models list --provider anthropic

Przykład konfiguracji

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

{
  agents: {
    defaults: {
      model: { primary: "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 utrzymywać wybór dostawcy/modelu jako anthropic/*, a backend wykonawczy umieszczać w agentRuntime.id.

Domyślne myślenie (Claude 4.6)

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

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

{
  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 pamięci podręcznej	Opis
`"short"` (domyślnie)	5 minut	Stosowane automatycznie dla uwierzytelniania kluczem API
`"long"`	1 godzina	Rozszerzona pamięć podręczna
`"none"`	Bez buforowania	Wyłącza buforowanie promptów

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

Nadpisania pamięci podręcznej dla agenta

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

{
  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 (dopasowanie id, nadpisuje według klucza)

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

Uwagi dotyczące Bedrock Claude

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

Konfiguracja zaawansowana

Tryb szybki

Wspólny przełącznik /fast 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"`

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

Rozumienie multimediów (obraz i PDF)

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

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

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

Okno kontekstu 1M (beta)

Okno kontekstu 1M Anthropic jest bramkowane wersją beta. Włącz je dla modelu:

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

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

params.context1m: true dotyczy również 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.

Kontekst 1M Claude Opus 4.7

anthropic/claude-opus-4.7 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 jest nieprawidłowy

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

Nie znaleziono klucza API dla dostawcy "anthropic"

Uwierzytelnianie Anthropic jest osobne dla każdego agenta — nowi agenci 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.

Nie znaleziono poświadczeń dla profilu "anthropic:default"

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

Brak dostępnego profilu uwierzytelniania (wszystkie w okresie 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 nadal może być użyteczny. Dodaj kolejny profil Anthropic albo poczekaj na zakończenie cooldown.

Powiązane

Wybór modelu

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

Backendy CLI

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

Buforowanie promptów

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

OAuth i uwierzytelnianie

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

# Pierwsze kroki

Klucz API

Uzyskaj klucz API

Uruchom onboarding

Zweryfikuj, czy model jest dostępny

# Przykład konfiguracji

Claude CLI

Upewnij się, że Claude CLI jest zainstalowany i zalogowany

Uruchom onboarding

Zweryfikuj, czy model jest dostępny

# Przykład konfiguracji

# Domyślne myślenie (Claude 4.6)

# Buforowanie promptów

# Konfiguracja zaawansowana

# Rozwiązywanie problemów

# Powiązane

Pierwsze kroki

Przykład konfiguracji

Przykład konfiguracji

Domyślne myślenie (Claude 4.6)

Buforowanie promptów

Konfiguracja zaawansowana

Rozwiązywanie problemów

Powiązane