Zum Hauptinhalt springen

​
Anthropic (Claude)

Anthropic entwickelt die Claude-Modellfamilie und stellt den Zugriff über eine API bereit. In OpenClaw können Sie sich mit einem API-Schlüssel oder einem Setup-Token authentifizieren.

​
Option A: Anthropic API-Schlüssel

Am besten geeignet für: Standard-API-Zugriff und nutzungsbasierte Abrechnung. Erstellen Sie Ihren API-Schlüssel in der Anthropic Console.

​
CLI-Einrichtung

openclaw onboard
# choose: Anthropic API key

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

​
Konfigurationsausschnitt

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

​
Prompt-Caching (Anthropic API)

OpenClaw unterstützt die Prompt-Caching-Funktion von Anthropic. Dies ist nur für die API verfügbar; eine Abonnement-Authentifizierung berücksichtigt Cache-Einstellungen nicht.

​
Konfiguration

Verwenden Sie den Parameter cacheRetention in Ihrer Modellkonfiguration:
WertCache-DauerBeschreibung
noneKein CachingPrompt-Caching deaktivieren
short5 MinutenStandard für API-Schlüssel-Auth
long1 StundeErweiterter Cache (erfordert Beta-Flag)
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

​
Standardwerte

Bei Verwendung der Anthropic-API-Schlüssel-Authentifizierung wendet OpenClaw automatisch cacheRetention: "short" (5-Minuten-Cache) für alle Anthropic-Modelle an. Sie können dies überschreiben, indem Sie cacheRetention explizit in Ihrer Konfiguration setzen.

​
Legacy-Parameter

Der ältere Parameter cacheControlTtl wird aus Gründen der Abwärtskompatibilität weiterhin unterstützt:
  • "5m" entspricht short
  • "1h" entspricht long
Wir empfehlen die Migration auf den neuen Parameter cacheRetention. OpenClaw enthält das extended-cache-ttl-2025-04-11-Beta-Flag für Anthropic-API-Anfragen; behalten Sie es bei, wenn Sie Provider-Header überschreiben (siehe /gateway/configuration).

​
Option B: Claude Setup-Token

Am besten geeignet für: die Nutzung Ihres Claude-Abonnements.

​
Wo Sie ein Setup-Token erhalten

Setup-Tokens werden von der Claude Code CLI erstellt, nicht von der Anthropic Console. Sie können dies auf jedem Rechner ausführen: 
claude setup-token
Fügen Sie das Token in OpenClaw ein (Assistent: Anthropic token (setup-token einfügen)), oder führen Sie es auf dem Gateway-Host aus: 
openclaw models auth setup-token --provider anthropic
Wenn Sie das Token auf einem anderen Rechner generiert haben, fügen Sie es ein: 
openclaw models auth paste-token --provider anthropic

​
CLI-Einrichtung (Setup-Token)

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

​
Konfigurationsausschnitt (Setup-Token)

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

​
Hinweise

​
Fehlerbehebung

401-Fehler / Token plötzlich ungültig
  • Die Authentifizierung für das Claude-Abonnement kann ablaufen oder widerrufen werden. Führen Sie claude setup-token erneut aus und fügen Sie es auf dem Gateway-Host ein.
  • Wenn die Claude-CLI-Anmeldung auf einem anderen Rechner erfolgt ist, verwenden Sie openclaw models auth paste-token --provider anthropic auf dem Gateway-Host.
Kein API-Schlüssel für Anbieter „anthropic“ gefunden
  • Die Authentifizierung erfolgt pro Agent. Neue Agenten übernehmen die Schlüssel des Hauptagenten nicht.
  • Führen Sie das Onboarding für diesen Agenten erneut aus oder fügen Sie ein Setup-Token / einen API-Schlüssel auf dem Gateway-Host ein und prüfen Sie anschließend mit openclaw models status.
Keine Anmeldedaten für Profil anthropic:default gefunden
  • Führen Sie openclaw models status aus, um zu sehen, welches Authentifizierungsprofil aktiv ist.
  • Führen Sie das Onboarding erneut aus oder fügen Sie ein Setup-Token / einen API-Schlüssel für dieses Profil ein.
Kein verfügbares Authentifizierungsprofil (alle in Cooldown/nicht verfügbar)
  • Prüfen Sie openclaw models status --json auf auth.unusableProfiles.
  • Fügen Sie ein weiteres Anthropic-Profil hinzu oder warten Sie den Cooldown ab.
Mehr: /gateway/troubleshooting und /help/faq.