Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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
Pracownicy Anthropic poinformowali nas, że użycie Claude CLI w stylu OpenClaw jest ponownie dozwolone, więc OpenClaw traktuje ponowne użycie Claude CLI i użycie claude -p jako zatwierdzone, chyba że Anthropic opublikuje nową politykę.W przypadku długotrwale działających hostów gateway klucze API Anthropic nadal są najjaśniejszą i najbardziej przewidywalną ścieżką produkcyjną.Aktualna publiczna dokumentacja Anthropic:

​
Pierwsze kroki

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

Get your API key

Utwórz klucz API w konsoli Anthropic.
2

Run onboarding

openclaw onboard
# choose: Anthropic API key
Albo przekaż klucz bezpośrednio:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

Verify the model is available

openclaw models list --provider anthropic

​
Przykład konfiguracji

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

​
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: 
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { thinking: "adaptive" },
        },
      },
    },
  },
}
Powiązana dokumentacja Anthropic:

​
Buforowanie promptów

OpenClaw obsługuje funkcję buforowania promptów Anthropic dla uwierzytelniania kluczem API.
WartośćCzas trwania buforaOpis
"short" (domyślnie)5 minutStosowane automatycznie dla uwierzytelniania kluczem API
"long"1 godzinaRozszerzony bufor
"none"Bez buforowaniaWyłącz buforowanie promptów
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
Użyj parametrów na poziomie modelu jako wartości bazowej, a następnie nadpisz konkretne agenty 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:
  1. agents.defaults.models["provider/model"].params
  2. 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.
  • 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

Wspólny przełącznik /fast w OpenClaw obsługuje bezpośredni ruch Anthropic (klucz API i OAuth do api.anthropic.com).
PolecenieMapuje na
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • Wstrzykiwane tylko dla bezpośrednich żądań do api.anthropic.com. Trasy proxy pozostawiają service_tier bez zmian.
  • Jawne parametry serviceTier lub service_tier nadpisują /fast, gdy ustawiono oba.
  • Na kontach bez pojemności Priority Tier service_tier: "auto" może zostać rozstrzygnięte jako standard.
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ślnyclaude-opus-4-7
Obsługiwane wejścieObrazy, dokumenty PDF
Gdy obraz lub PDF zostanie dołączony do rozmowy, OpenClaw automatycznie kieruje go przez dostawcę rozumienia multimediów Anthropic.
Okno kontekstu 1M Anthropic jest objęte dostępem beta. Włącz je dla modelu:
{
  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.
Wymaga dostępu do długiego kontekstu na Twoim poświadczeniu Anthropic. Starsze uwierzytelnianie tokenem (sk-ant-oat-*) jest odrzucane dla żądań kontekstu 1M — OpenClaw zapisuje ostrzeżenie i wraca do standardowego okna kontekstu.
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

Uwierzytelnianie tokenem Anthropic wygasa i może zostać unieważnione. W przypadku nowych konfiguracji użyj zamiast tego klucza API 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.
Uruchom openclaw models status, aby sprawdzić, który profil uwierzytelniania jest aktywny. Uruchom ponownie onboarding albo skonfiguruj klucz API dla ścieżki tego profilu.
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.
Więcej pomocy: Rozwiązywanie problemów i FAQ.

​
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ń.