OpenClaw mit Anthropic Claude verbinden: API-Guide

Kennst du das? Du willst die neuesten Claude-Modelle in deinen Workflow integrieren, aber die verschiedenen Authentifizierungsmethoden und Konfigurationen halten dich auf. Egal ob du den klassischen API-Key nutzt oder dein Claude-Abo über das CLI einbinden willst – hier erfährst du, wie du Anthropic optimal mit OpenClaw nutzt.

Anthropic entwickelt die Claude Modellfamilie und bietet Zugriff über eine API an. In OpenClaw kannst du dich mit einem API-Key oder einem setup-token authentifizieren.

Option A: Anthropic API-Key

Am besten für: Standard-API-Zugriff und nutzungsbasierte Abrechnung. Erstelle deinen API-Key in der Anthropic Console.

CLI setup

openclaw onboard
# choose: Anthropic API key

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

Claude CLI config snippet

{
  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 nutzen in OpenClaw standardmäßig adaptive Thinking, wenn kein explizites Thinking-Level festgelegt ist.
• Du kannst dies pro Nachricht (/think:<level>) oder in den Modell-Parametern überschreiben: agents.defaults.models["anthropic/<model>"].params.thinking.
• Verwandte Anthropic-Docs:
  • Adaptive thinking
  • Extended thinking

Fast Mode (Anthropic API)

Der geteilte /fast Switch von OpenClaw unterstützt auch direkten öffentlichen Anthropic-Traffic. Das gilt für API-Key- und OAuth-authentifizierte Anfragen an api.anthropic.com.

• /fast on wird auf service_tier: "auto" gemappt
• /fast off wird auf service_tier: "standard_only" gemappt
• Config-Standardwert:

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

Wichtige Einschränkungen:

• OpenClaw fügt Anthropic Service-Tiers nur bei direkten Anfragen an api.anthropic.com ein. Wenn du anthropic/* über einen Proxy oder ein Gateway leitest, lässt /fast den service_tier unverändert.
• Explizite Anthropic serviceTier oder service_tier Modell-Parameter überschreiben den /fast Standardwert, wenn beide gesetzt sind.
• Anthropic meldet den effektiven Tier in der Antwort unter usage.service_tier. Bei Accounts ohne Priority-Tier-Kapazität kann service_tier: "auto" trotzdem als standard aufgelöst werden.

Prompt Caching (Anthropic API)

OpenClaw unterstützt das Prompt Caching von Anthropic. Dies funktioniert nur über die API; bei einer Authentifizierung via Abo werden die Cache-Einstellungen nicht berücksichtigt.

Konfiguration

Verwende den Parameter cacheRetention in deiner Modell-Konfiguration:

Wert	Cache-Dauer	Beschreibung
none	Kein Caching	Deaktiviert Prompt Caching
short	5 Minuten	Standard für API-Key Authentifizierung
long	1 Stunde	Erweiterter Cache (benötigt Beta-Flag)

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

Standardwerte

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

cacheRetention Overrides pro Agent

Nutze Modell-Parameter als Basis und überschreibe dann spezifische Agents via agents.list[].params.

{
  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
    ],
  },
}

Reihenfolge der Konfigurations-Zusammenführung für Cache-Parameter:

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

So kann ein Agent einen langlebigen Cache behalten, während ein anderer Agent auf demselben Modell Caching deaktiviert, um Schreibkosten bei unregelmäßigem Traffic zu vermeiden.

Hinweise zu Bedrock Claude

• Anthropic Claude Modelle auf Bedrock (amazon-bedrock/*anthropic.claude*) akzeptieren cacheRetention als Pass-Through, wenn konfiguriert.
• Nicht-Anthropic Bedrock Modelle werden zur Laufzeit auf cacheRetention: "none" gesetzt.
• Die Smart-Defaults für Anthropic API-Keys setzen auch cacheRetention: "short" für Claude-on-Bedrock Modell-Referenzen, wenn kein expliziter Wert gesetzt ist.

Veraltete Parameter

Der ältere Parameter cacheControlTtl wird aus Gründen der Abwärtskompatibilität weiterhin unterstützt:

• "5m" wird zu short gemappt
• "1h" wird zu long gemappt

Wir empfehlen den Umstieg auf den neuen Parameter cacheRetention.

OpenClaw enthält das Beta-Flag extended-cache-ttl-2025-04-11 für Anthropic API-Anfragen. Behalte es bei, falls du Provider-Header überschreibst (siehe /gateway/configuration).

1M Context Window (Anthropic Beta)

Das 1M Context Window von Anthropic ist aktuell in der Beta-Phase. Aktiviere es in OpenClaw 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 mappt dies bei Anthropic-Anfragen auf anthropic-beta: context-1m-2025-08-07.

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

Voraussetzung: Anthropic muss die Nutzung des langen Kontextes für diese Zugangsdaten erlauben (normalerweise API-Key Abrechnung oder ein Abo-Account mit aktiviertem “Extra Usage”). Andernfalls gibt Anthropic zurück: HTTP 429: rate_limit_error: Extra usage is required for long context requests.

Hinweis: Anthropic lehnt context-1m-* Beta-Anfragen derzeit ab, wenn Subscription-Setup-Token (sk-ant-oat-*) verwendet werden. Wenn du context1m: true mit Abo-Authentifizierung konfigurierst, loggt OpenClaw eine Warnung und nutzt das Standard-Context-Window, indem der Beta-Header weggelassen wird.

Option B: Claude CLI als Message-Provider

Am besten für: Einen Single-User Gateway-Host, auf dem das Claude CLI bereits installiert und mit einem Claude-Abo angemeldet ist.

Dieser Weg nutzt die lokale claude Binary für die Modell-Inferenz, anstatt die Anthropic API direkt aufzurufen. OpenClaw behandelt dies als einen CLI-Backend-Provider mit Modell-Referenzen wie:

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

So funktioniert es:

1. OpenClaw startet claude -p --output-format json ... auf dem Gateway-Host.
2. Der erste Turn sendet --session-id <uuid>.
3. Folgende Turns nutzen die gespeicherte Claude-Session via --resume <sessionId> wieder.
4. Deine Chat-Nachrichten laufen weiterhin durch die normale OpenClaw Pipeline, aber die eigentliche Antwort wird vom Claude CLI generiert.

Anforderungen

• Claude CLI ist auf dem Gateway-Host installiert und im PATH verfügbar oder mit einem absoluten Pfad konfiguriert.
• Claude CLI ist auf demselben Host bereits authentifiziert:

claude auth status

• OpenClaw lädt das integrierte Anthropic-Plugin beim Gateway-Start automatisch, wenn deine Konfiguration explizit auf claude-cli/... oder eine claude-cli Backend-Konfiguration verweist.

Config snippet

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

Falls die claude Binary nicht im PATH des Gateway-Hosts liegt:

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

Deine Vorteile

• Claude-Abo-Authentifizierung wird vom lokalen CLI übernommen
• Normales OpenClaw Nachrichten- und Session-Routing
• Kontinuität der Claude CLI Session über mehrere Turns hinweg

Von Anthropic-Auth zu Claude CLI migrieren

Wenn du aktuell anthropic/... mit einem Setup-Token oder API-Key nutzt und denselben Gateway-Host auf Claude CLI umstellen möchtest:

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

Oder während des Onboardings:

openclaw onboard --auth-choice anthropic-cli

Was dabei passiert:

• Es wird geprüft, ob das Claude CLI auf dem Gateway-Host angemeldet ist.
• Das Standardmodell wird auf claude-cli/... umgestellt.
• Anthropic Default-Modell Fallbacks wie anthropic/claude-opus-4-6 werden zu claude-cli/claude-opus-4-6 umgeschrieben.
• Passende claude-cli/... Einträge werden zu agents.defaults.models hinzugefügt.

Was dabei nicht passiert:

• Deine bestehenden Anthropic-Auth-Profile werden nicht gelöscht.
• Alte anthropic/... Konfigurations-Referenzen außerhalb des Hauptpfads werden nicht entfernt.

Das macht einen Rollback einfach: Ändere das Standardmodell bei Bedarf einfach wieder zurück auf anthropic/....

Wichtige Einschränkungen

• Dies ist nicht der Anthropic API-Provider, sondern die lokale CLI-Runtime.
• Tools sind auf der OpenClaw-Seite für CLI-Backend-Runs deaktiviert.
• Text rein, Text raus. Kein OpenClaw Streaming-Handoff.
• Am besten für einen persönlichen Gateway-Host geeignet, nicht für geteilte Multi-User Setups.

Mehr Details: /gateway/cli-backends

Option C: Claude Setup-Token

Am besten für: Die Nutzung deines Claude-Abos.

Woher bekomme ich einen Setup-Token?

Setup-Token werden durch das Claude Code CLI erstellt, nicht in der Anthropic Console. Du kannst dies auf jedem beliebigen Rechner ausführen:

claude setup-token

Füge den Token in OpenClaw ein (Wizard: Anthropic token (paste setup-token)) oder führe den Befehl auf dem Gateway-Host aus:

openclaw models auth setup-token --provider anthropic

Wenn du den Token auf einem anderen Rechner generiert hast, füge ihn ein:

openclaw models auth paste-token --provider anthropic

CLI setup (setup-token)

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

Config snippet (setup-token)

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

Hinweise

• Generiere den Setup-Token mit claude setup-token und füge ihn ein, oder nutze openclaw models auth setup-token auf dem Gateway-Host.
• Wenn du bei einem Claude-Abo die Meldung „OAuth token refresh failed …“ siehst, authentifiziere dich erneut mit einem Setup-Token. Siehe /gateway/troubleshooting.
• Auth-Details und Regeln zur Wiederverwendung findest du unter /concepts/oauth.

Fehlerbehebung

401 Fehler / Token plötzlich ungültig

• Die Claude-Abo-Authentifizierung kann ablaufen oder widerrufen werden. Führe claude setup-token erneut aus und füge den Token auf dem Gateway-Host ein.
• Wenn der Claude CLI Login auf einem anderen Rechner liegt, nutze openclaw models auth paste-token --provider anthropic auf dem Gateway-Host.

Kein API-Key für Provider “anthropic” gefunden

• Die Authentifizierung erfolgt pro Agent. Neue Agents erben nicht automatisch die Keys des Haupt-Agents.
• Starte das Onboarding für diesen Agent neu oder füge einen Setup-Token / API-Key auf dem Gateway-Host ein und prüfe dies mit openclaw models status.

Keine Zugangsdaten für Profil anthropic:default gefunden

• Nutze openclaw models status, um zu sehen, welches Auth-Profil aktiv ist.
• Starte das Onboarding neu oder füge einen Setup-Token / API-Key für dieses Profil ein.

Kein verfügbares Auth-Profil (alle im Cooldown/nicht verfügbar)

• Prüfe openclaw models status --json auf auth.unusableProfiles.
• Füge ein weiteres Anthropic-Profil hinzu oder warte den Cooldown ab.

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

Nächste Schritte

• Konfiguration des Gateways
• Fehlerbehebung Guide

AI Setup Assistant