​

Anthropic (Claude)

​

Opcja A: klucz API Anthropic

​

Konfiguracja CLI

openclaw onboard
# wybierz: Anthropic API key

# lub nieinteraktywnie
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

​

Fragment konfiguracji Claude CLI

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

​

Domyślne ustawienia thinking (Claude 4.6)

• Modele Anthropic Claude 4.6 domyślnie używają adaptive thinking w OpenClaw, gdy nie ustawiono jawnie poziomu thinking.
• Możesz to nadpisać dla pojedynczej wiadomości (/think:<level>) albo w parametrach modelu: agents.defaults.models["anthropic/<model>"].params.thinking.
• Powiązana dokumentacja Anthropic:
  • Adaptive thinking
  • Extended thinking

​

Tryb fast (Anthropic API)

• /fast on mapuje się na service_tier: "auto"
• /fast off mapuje się na service_tier: "standard_only"
• Domyślna konfiguracja:

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

• OpenClaw wstrzykuje poziomy usługi Anthropic tylko dla bezpośrednich żądań do api.anthropic.com. Jeśli kierujesz anthropic/* przez proxy lub Gateway, /fast pozostawia service_tier bez zmian.
• Jawne parametry modelu Anthropic serviceTier lub service_tier mają pierwszeństwo przed domyślnym /fast, jeśli ustawione są oba.
• Anthropic raportuje efektywny poziom w odpowiedzi pod usage.service_tier. Na kontach bez pojemności Priority Tier wartość service_tier: "auto" może nadal zostać rozstrzygnięta jako standard.

​

Cache promptów (Anthropic API)

​

Konfiguracja

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

​

Wartości domyślne

​

Nadpisania cacheRetention dla poszczególnych agentów

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // wartość bazowa dla większości agentów
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // nadpisanie tylko dla tego agenta
    ],
  },
}

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

​

Uwagi dotyczące Bedrock Claude

• Modele Anthropic Claude w Bedrock (amazon-bedrock/*anthropic.claude*) akceptują przekazanie cacheRetention, jeśli jest skonfigurowane.
• Dla modeli Bedrock innych niż Anthropic runtime wymusza cacheRetention: "none".
• Inteligentne wartości domyślne Anthropic API key ustawiają też cacheRetention: "short" dla referencji modeli Claude-on-Bedrock, gdy nie ustawiono jawnej wartości.

​

Okno kontekstu 1M (beta Anthropic)

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

​

Opcja B: Claude CLI jako provider wiadomości

• claude-cli/claude-sonnet-4-6
• claude-cli/claude-opus-4-6

1. OpenClaw uruchamia claude -p --output-format stream-json --include-partial-messages ... na hoście Gateway i wysyła prompt przez stdin.
2. Pierwsza tura wysyła --session-id <uuid>.
3. Kolejne tury ponownie używają zapisanej sesji Claude przez --resume <sessionId>.
4. Twoje wiadomości czatu nadal przechodzą przez normalny pipeline wiadomości OpenClaw, ale faktyczna odpowiedź modelu jest generowana przez Claude CLI.

​

Wymagania

• Claude CLI zainstalowane na hoście Gateway i dostępne w PATH albo skonfigurowane z bezwzględną ścieżką polecenia.
• Claude CLI już uwierzytelnione na tym samym hoście:

claude auth status

• OpenClaw automatycznie ładuje zbundlowany plugin Anthropic podczas uruchamiania Gateway, gdy konfiguracja jawnie odwołuje się do claude-cli/... lub konfiguracji backendu claude-cli.

​

Fragment konfiguracji

{
  agents: {
    defaults: {
      model: {
        primary: "claude-cli/claude-sonnet-4-6",
      },
      models: {
        "claude-cli/claude-sonnet-4-6": {},
      },
      sandbox: { mode: "off" },
    },
  },
}

{
  agents: {
    defaults: {
      cliBackends: {
        "claude-cli": {
          command: "/opt/homebrew/bin/claude",
        },
      },
    },
  },
}

​

Co otrzymujesz

• Ponowne użycie uwierzytelniania subskrypcji Claude z lokalnego CLI (odczytywane w runtime, bez trwałego zapisu)
• Normalne routowanie wiadomości/sesji OpenClaw
• Ciągłość sesji Claude CLI między turami (unieważniana przy zmianach uwierzytelniania)
• Narzędzia Gateway udostępniane Claude CLI przez most MCP local loopback
• Strumieniowanie JSONL z postępem wiadomości częściowych na żywo

​

Migracja z uwierzytelniania Anthropic do Claude CLI

• Claude CLI zainstalowane na tym samym hoście Gateway, na którym działa OpenClaw
• Claude CLI już tam zalogowane: claude auth login

openclaw models auth login --provider anthropic --method cli --set-default

openclaw onboard --auth-choice anthropic-cli

• weryfikuje, że Claude CLI jest już zalogowane na hoście Gateway
• przełącza model domyślny na claude-cli/...
• przepisuje domyślne fallbacki modeli Anthropic, takie jak anthropic/claude-opus-4-6, na claude-cli/claude-opus-4-6
• dodaje pasujące wpisy claude-cli/... do agents.defaults.models

openclaw models status

• nie usuwa istniejących profili uwierzytelniania Anthropic
• nie usuwa każdego starego odwołania do konfiguracji anthropic/... poza główną domyślną ścieżką modelu/listy dozwolonych

​

Ważne ograniczenia

• To nie jest provider API Anthropic. To lokalny runtime CLI.
• OpenClaw nie wstrzykuje bezpośrednio wywołań narzędzi. Claude CLI otrzymuje narzędzia Gateway przez most MCP local loopback (bundleMcp: true, domyślnie).
• Claude CLI strumieniuje odpowiedzi przez JSONL (stream-json z --include-partial-messages). Prompty są wysyłane przez stdin, a nie argv.
• Uwierzytelnianie jest odczytywane w runtime z aktywnych poświadczeń Claude CLI i nie jest trwale zapisywane w profilach OpenClaw. Monity pęku kluczy są wyciszane w kontekstach nieinteraktywnych.
• Ponowne użycie sesji jest śledzone przez metadane cliSessionBinding. Gdy stan logowania Claude CLI się zmienia (ponowne logowanie, rotacja tokenu), zapisane sesje są unieważniane i rozpoczyna się nowa sesja.
• Najlepiej nadaje się do osobistego hosta Gateway, a nie do współdzielonych konfiguracji rozliczeń dla wielu użytkowników.

​

Uwagi

• Publiczna dokumentacja Claude Code od Anthropic nadal opisuje bezpośrednie użycie CLI, takie jak claude -p. Uważamy, że lokalny fallback zarządzany przez użytkownika jest prawdopodobnie dozwolony, ale osobne powiadomienie Anthropic dla użytkowników OpenClaw mówi, że ścieżka logowania Claude w OpenClaw jest użyciem third-party harness i wymaga Extra Usage (pay-as-you-go rozliczanego oddzielnie od subskrypcji). Do zastosowań produkcyjnych zalecamy zamiast tego klucze API Anthropic.
• Anthropic setup-token jest ponownie dostępny w OpenClaw jako starsza/ręczna ścieżka. Powiadomienie Anthropic dotyczące rozliczeń specyficznych dla OpenClaw nadal obowiązuje, więc używaj tej opcji ze świadomością, że Anthropic wymaga Extra Usage dla tej ścieżki.
• Szczegóły uwierzytelniania i reguły ponownego użycia znajdziesz w /concepts/oauth.

​

Rozwiązywanie problemów

• Starsze uwierzytelnianie tokenem Anthropic może wygasnąć lub zostać cofnięte.
• W przypadku nowej konfiguracji przejdź na klucz API Anthropic albo lokalną ścieżkę Claude CLI na hoście Gateway.

• Uwierzytelnianie jest per agent. Nowi agenci nie dziedziczą kluczy głównego agenta.
• Ponownie uruchom onboarding dla tego agenta albo skonfiguruj klucz API na hoście Gateway, a następnie zweryfikuj przez openclaw models status.

• Uruchom openclaw models status, aby sprawdzić, który profil uwierzytelniania jest aktywny.
• Ponownie uruchom onboarding albo skonfiguruj klucz API lub Claude CLI dla tej ścieżki profilu.

• Sprawdź openclaw models status --json pod kątem auth.unusableProfiles.
• Cooldowny limitu szybkości Anthropic mogą być zależne od modelu, więc pokrewny model Anthropic może nadal być używalny, nawet gdy bieżący jest w cooldown.
• Dodaj kolejny profil Anthropic albo poczekaj na koniec cooldown.