​

Anthropic (Claude)

​

Opcja A: klucz API Anthropic

​

Konfiguracja CLI

openclaw onboard
# choose: Anthropic API key

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

​

Fragment konfiguracji Anthropic

{
  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>) lub 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 do service_tier: "auto"
• /fast off mapuje do service_tier: "standard_only"
• Domyślna konfiguracja:

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

• OpenClaw wstrzykuje poziomy usług 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, gdy ustawiono 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 rozwiązać się do standard.

​

Prompt caching (Anthropic API)

​

Konfiguracja

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

​

Wartości domyślne

​

Nadpisania cacheRetention per agent

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // baseline for most agents
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // override for this agent only
    ],
  },
}

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

​

Uwagi o Bedrock Claude

• Modele Anthropic Claude w Bedrock (amazon-bedrock/*anthropic.claude*) akceptują przekazywanie cacheRetention, jeśli jest skonfigurowane.
• Modele Bedrock inne niż Anthropic są wymuszane w runtime do cacheRetention: "none".
• Inteligentne wartości domyślne dla kluczy API Anthropic ustawiają także cacheRetention: "short" dla odwołań do modeli Claude-on-Bedrock, gdy nie ustawiono jawnej wartości.

​

Okno kontekstu 1M (Anthropic beta)

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

​

Backend Claude CLI

• Pracownicy Anthropic powiedzieli nam, że to użycie jest ponownie dozwolone.
• OpenClaw dlatego traktuje ponowne użycie Claude CLI i użycie claude -p jako usankcjonowane dla tej integracji, chyba że Anthropic opublikuje nową politykę.
• Klucze API Anthropic pozostają najjaśniejszą ścieżką produkcyjną dla stale działających hostów gateway oraz jawnej kontroli rozliczeń po stronie serwera.
• Szczegóły konfiguracji i runtime znajdują się w /gateway/cli-backends.

​

Uwagi

• Publiczna dokumentacja Claude Code Anthropic nadal opisuje bezpośrednie użycie CLI, takie jak claude -p, a pracownicy Anthropic powiedzieli nam, że użycie Claude CLI w stylu OpenClaw jest ponownie dozwolone. Traktujemy te wytyczne jako ustalone, chyba że Anthropic opublikuje nową zmianę polityki.
• Anthropic setup-token pozostaje dostępny w OpenClaw jako obsługiwana ścieżka uwierzytelniania tokenem, ale OpenClaw teraz preferuje ponowne użycie Claude CLI i claude -p, gdy są dostępne.
• Szczegóły auth + zasady ponownego użycia znajdują się w /concepts/oauth.

​

Rozwiązywanie problemów

• Uwierzytelnianie tokenem Anthropic może wygasnąć lub zostać cofnięte.
• Dla nowej konfiguracji przejdź na klucz API Anthropic.

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

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

• Sprawdź openclaw models status --json dla auth.unusableProfiles.
• Cooldowny limitów Anthropic mogą być ograniczone do konkretnego modelu, więc pokrewny model Anthropic może nadal być użyteczny nawet wtedy, gdy bieżący jest w cooldownie.
• Dodaj kolejny profil Anthropic albo poczekaj na koniec cooldownu.