Anthropic (Claude)

Anthropic tworzy rodzinę modeli Claude i udostępnia do nich dostęp przez API. W OpenClaw możesz uwierzytelniać się za pomocą klucza API lub setup-token.

Opcja A: klucz API Anthropic

Najlepsze dla: standardowego dostępu do API i rozliczania opartego na użyciu. Utwórz klucz API w konsoli Anthropic.

Konfiguracja CLI

openclaw onboard
# choose: Anthropic API key

# or non-interactive
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

Fragment konfiguracji

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

Buforowanie promptów (API Anthropic)

OpenClaw obsługuje funkcję buforowania promptów Anthropic. Jest to wyłącznie API; uwierzytelnianie subskrypcyjne nie respektuje ustawień cache.

Konfiguracja

Użyj parametru cacheRetention w konfiguracji modelu:

Wartość	Czas cache	Opis
`none`	Brak cache	Wyłącza buforowanie promptów
`short`	5 minut	Domyślne dla uwierzytelniania kluczem API
`long`	1 godzina	Rozszerzony cache (wymaga flagi beta)

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

Ustawienia domyślne

Podczas używania uwierzytelniania kluczem API Anthropic, OpenClaw automatycznie stosuje cacheRetention: "short" (cache 5‑minutowy) dla wszystkich modeli Anthropic. Możesz to nadpisać, jawnie ustawiając cacheRetention w konfiguracji.

Parametr starszy

Starszy parametr cacheControlTtl jest nadal obsługiwany w celu zachowania zgodności wstecznej:

"5m" mapuje się na short
"1h" mapuje się na long

Zalecamy migrację do nowego parametru cacheRetention. OpenClaw zawiera flagę beta extended-cache-ttl-2025-04-11 dla żądań API Anthropic; zachowaj ją, jeśli nadpisujesz nagłówki dostawcy (zob. /gateway/configuration).

Opcja B: setup-token Claude

Najlepsze dla: korzystania z subskrypcji Claude.

Gdzie uzyskać setup-token

Setup-tokeny są tworzone przez Claude Code CLI, a nie w konsoli Anthropic. Możesz uruchomić to na dowolnej maszynie:

claude setup-token

Wklej token do OpenClaw (kreator: Anthropic token (paste setup-token)) lub uruchom go na hoście Gateway:

openclaw models auth setup-token --provider anthropic

Jeśli wygenerowałeś token na innej maszynie, wklej go:

openclaw models auth paste-token --provider anthropic

Konfiguracja CLI (setup-token)

# Paste a setup-token during onboarding
openclaw onboard --auth-choice setup-token

Fragment konfiguracji (setup-token)

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

Uwagi

Wygeneruj setup-token za pomocą claude setup-token i wklej go albo uruchom openclaw models auth setup-token na hoście Gateway.
Jeśli zobaczysz komunikat „OAuth token refresh failed …” przy subskrypcji Claude, ponownie uwierzytelnij się przy użyciu setup-token. Zobacz /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription.
Szczegóły uwierzytelniania i zasady ponownego użycia znajdują się w /concepts/oauth.

Rozwiązywanie problemów

Błędy 401 / token nagle nieważny

Uwierzytelnianie subskrypcji Claude może wygasnąć lub zostać cofnięte. Uruchom ponownie claude setup-token i wklej je na hoście Gateway.
Jeśli logowanie w Claude CLI znajduje się na innej maszynie, użyj openclaw models auth paste-token --provider anthropic na hoście Gateway.

Nie znaleziono klucza API dla dostawcy „anthropic”

Uwierzytelnianie jest na agenta. Nowi agenci nie dziedziczą kluczy głównego agenta.
Uruchom ponownie onboarding dla tego agenta lub wklej setup-token / 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 sprawdzić, który profil uwierzytelniania jest aktywny.
Uruchom ponownie onboarding lub wklej setup-token / klucz API dla tego profilu.

Brak dostępnego profilu uwierzytelniania (wszystkie w cooldownie / niedostępne)

Sprawdź openclaw models status --json pod kątem auth.unusableProfiles.
Dodaj kolejny profil Anthropic lub poczekaj na zakończenie cooldownu.

Więcej: /gateway/troubleshooting oraz /help/faq.

Przegląd

Koncepcje modeli

Konfiguracja

Dostawcy

„Anthropic”

Anthropic (Claude)

Opcja A: klucz API Anthropic

Konfiguracja CLI

Fragment konfiguracji

Buforowanie promptów (API Anthropic)

Konfiguracja

Ustawienia domyślne

Parametr starszy

Opcja B: setup-token Claude

Gdzie uzyskać setup-token

Konfiguracja CLI (setup-token)

Fragment konfiguracji (setup-token)

Uwagi

Rozwiązywanie problemów

​Anthropic (Claude)

​Opcja A: klucz API Anthropic

​Konfiguracja CLI

​Fragment konfiguracji

​Buforowanie promptów (API Anthropic)

​Konfiguracja

​Ustawienia domyślne

​Parametr starszy

​Opcja B: setup-token Claude

​Gdzie uzyskać setup-token

​Konfiguracja CLI (setup-token)

​Fragment konfiguracji (setup-token)

​Uwagi

​Rozwiązywanie problemów

Anthropic (Claude)

Opcja A: klucz API Anthropic

Konfiguracja CLI

Fragment konfiguracji

Buforowanie promptów (API Anthropic)

Konfiguracja

Ustawienia domyślne

Parametr starszy

Opcja B: setup-token Claude

Gdzie uzyskać setup-token

Konfiguracja CLI (setup-token)

Fragment konfiguracji (setup-token)

Uwagi

Rozwiązywanie problemów