Anthropic (Claude)

Anthropic entwickelt die Claude-Modellfamilie und bietet Zugang über eine API. In OpenClaw kannst du dich mit einem API-Key oder einem Setup-Token authentifizieren.

Option A: Anthropic API-Key

Ideal für: Standard-API-Zugang und nutzungsbasierte Abrechnung. Erstelle deinen API-Key in der Anthropic Console.

CLI-Einrichtung

openclaw onboard
# wähle: Anthropic API key

# oder nicht-interaktiv
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

Konfigurationsbeispiel

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

Thinking-Standardwerte (Claude 4.6)

Anthropic Claude 4.6-Modelle verwenden in OpenClaw standardmäßig adaptive Thinking, wenn kein explizites Thinking-Level gesetzt ist.
Du kannst es pro Nachricht (/think:<level>) oder in den Modellparametern überschreiben: agents.defaults.models["anthropic/<model>"].params.thinking.
Zugehörige Anthropic-Dokumentation:
- Adaptive thinking
- Extended thinking

Fast-Modus (Anthropic API)

OpenClaws gemeinsamer /fast-Schalter unterstützt auch direkten Anthropic-API-Key-Traffic.

/fast on wird zu service_tier: "auto"
/fast off wird zu service_tier: "standard_only"
Konfigurationsstandard:

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

Wichtige Einschränkungen:

Das funktioniert nur mit API-Key. Anthropic Setup-Token / OAuth-Authentifizierung berücksichtigt die OpenClaw Fast-Mode-Tier-Injection nicht.
OpenClaw injiziert Anthropic Service-Tiers nur für direkte api.anthropic.com-Anfragen. Wenn du anthropic/* über einen Proxy oder Gateway leitest, lässt /fast den service_tier unverändert.
Anthropic gibt den effektiven Tier in der Antwort unter usage.service_tier zurück. Bei Konten ohne Priority-Tier-Kapazität kann service_tier: "auto" trotzdem zu standard aufgelöst werden.

Prompt-Caching (Anthropic API)

OpenClaw unterstützt Anthropics Prompt-Caching-Funktion. Das ist nur für die API; Abonnement-Authentifizierung berücksichtigt Cache-Einstellungen nicht.

Konfiguration

Verwende den cacheRetention-Parameter in deiner Modellkonfiguration:

Wert	Cache-Dauer	Beschreibung
`none`	Kein Caching	Prompt-Caching deaktivieren
`short`	5 Minuten	Standard für API-Key-Authentifizierung
`long`	1 Stunde	Erweiterter Cache (erfordert Beta-Flag)

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

Standardwerte

Bei Verwendung der Anthropic API-Key-Authentifizierung wendet OpenClaw automatisch cacheRetention: "short" (5-Minuten-Cache) für alle Anthropic-Modelle an. Du kannst das überschreiben, indem du cacheRetention explizit in deiner Konfiguration setzt.

cacheRetention-Überschreibungen pro Agent

Verwende Parameter auf Modellebene als Basis und überschreibe einzelne Agents über agents.list[].params.

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // Basis für die meisten Agents
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // Überschreibung nur für diesen Agent
    ],
  },
}

Merge-Reihenfolge für Cache-bezogene Parameter:

agents.defaults.models["provider/model"].params
agents.list[].params (passende id, überschreibt nach Key)

So kann ein Agent einen langlebigen Cache behalten, während ein anderer Agent mit demselben Modell das Caching deaktiviert, um Schreibkosten bei stoßartigem/wenig wiederverwendetem Traffic zu vermeiden.

Bedrock-Claude-Hinweise

Anthropic Claude-Modelle auf Bedrock (amazon-bedrock/*anthropic.claude*) akzeptieren cacheRetention-Passthrough, wenn konfiguriert.
Nicht-Anthropic-Bedrock-Modelle werden zur Laufzeit auf cacheRetention: "none" gesetzt.
Die smarten API-Key-Standardwerte von Anthropic setzen auch cacheRetention: "short" für Claude-on-Bedrock-Modellreferenzen, wenn kein expliziter Wert gesetzt ist.

Legacy-Parameter

Der ältere cacheControlTtl-Parameter wird aus Kompatibilitätsgründen weiterhin unterstützt:

"5m" entspricht short
"1h" entspricht long

Wir empfehlen die Migration zum neuen cacheRetention-Parameter.

OpenClaw fügt den extended-cache-ttl-2025-04-11 Beta-Flag für Anthropic-API-Anfragen ein; behalte ihn bei, wenn du Provider-Header überschreibst (siehe /gateway/configuration).

1M-Kontextfenster (Anthropic Beta)

Anthropics 1M-Kontextfenster ist Beta-beschränkt. In OpenClaw aktivierst du es pro Modell mit params.context1m: true für unterstützte Opus/Sonnet-Modelle.

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

OpenClaw setzt dies auf anthropic-beta: context-1m-2025-08-07 bei Anthropic-Anfragen um.

Das wird nur aktiviert, wenn params.context1m für das jeweilige Modell explizit auf true gesetzt ist.

Voraussetzung: Anthropic muss Long-Context-Nutzung für diese Anmeldeinformationen erlauben (typischerweise API-Key-Abrechnung oder ein Abonnement-Konto mit aktivierter Extra Usage). Andernfalls gibt Anthropic zurück: HTTP 429: rate_limit_error: Extra usage is required for long context requests.

Hinweis: Anthropic lehnt derzeit context-1m-* Beta-Anfragen bei Verwendung von OAuth/Abonnement-Tokens (sk-ant-oat-*) ab. OpenClaw überspringt den context1m-Beta-Header automatisch bei OAuth-Authentifizierung und behält die erforderlichen OAuth-Betas bei.

Option B: Claude Setup-Token

Ideal für: Nutzung deines Claude-Abonnements.

Wo du ein Setup-Token bekommst

Setup-Tokens werden von der Claude Code CLI erstellt, nicht von der Anthropic Console. Du kannst das auf jedem Rechner ausführen:

claude setup-token

Füge das Token in OpenClaw ein (Assistent: Anthropic token (paste setup-token)), oder führe es auf dem Gateway-Host aus:

openclaw models auth setup-token --provider anthropic

Wenn du das Token auf einem anderen Rechner generiert hast, füge es ein:

openclaw models auth paste-token --provider anthropic

CLI-Einrichtung (Setup-Token)

# Setup-Token während des Onboardings einfügen
openclaw onboard --auth-choice setup-token

Konfigurationsbeispiel (Setup-Token)

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

Hinweise

Generiere das Setup-Token mit claude setup-token und füge es ein, oder führe openclaw models auth setup-token auf dem Gateway-Host aus.
Wenn du “OAuth token refresh failed …” bei einem Claude-Abonnement siehst, authentifiziere dich erneut mit einem Setup-Token. Siehe /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription.
Authentifizierungsdetails und Wiederverwendungsregeln findest du unter /concepts/oauth.

Fehlerbehebung

401-Fehler / Token plötzlich ungültig

Claude-Abonnement-Authentifizierung kann ablaufen oder widerrufen werden. Führe claude setup-token erneut aus und füge es auf dem Gateway-Host ein.
Wenn die Claude CLI-Anmeldung auf einem anderen Rechner liegt, verwende openclaw models auth paste-token --provider anthropic auf dem Gateway-Host.

No API key found for provider “anthropic”

Authentifizierung ist pro Agent. Neue Agents erben nicht die Keys des Haupt-Agents.
Führe das Onboarding für diesen Agent erneut aus, oder füge ein Setup-Token / einen API-Key auf dem Gateway-Host ein, dann überprüfe mit openclaw models status.

No credentials found for profile anthropic:default

Führe openclaw models status aus, um zu sehen, welches Auth-Profil aktiv ist.
Führe das Onboarding erneut aus, oder füge ein Setup-Token / einen API-Key für dieses Profil ein.

No available auth profile (all in cooldown/unavailable)

Prüfe openclaw models status --json für auth.unusableProfiles.
Füge ein weiteres Anthropic-Profil hinzu oder warte auf das Cooldown-Ende.

Mehr: /gateway/troubleshooting und /help/faq.