Providers
Anthropic
Anthropic entwickelt die Modellfamilie Claude. OpenClaw unterstützt zwei Authentifizierungswege:
- API-Schlüssel — direkter Anthropic-API-Zugriff mit nutzungsbasierter Abrechnung (
anthropic/*-Modelle) - Claude CLI — eine vorhandene Claude Code-Anmeldung auf demselben Host wiederverwenden
Erste Schritte
API-Schlüssel
Am besten geeignet für: standardmäßigen API-Zugriff und nutzungsbasierte Abrechnung.
Ihren API-Schlüssel abrufen
Erstellen Sie einen API-Schlüssel in der Anthropic Console.
Onboarding ausführen
openclaw onboard# choose: Anthropic API keyOder übergeben Sie den Schlüssel direkt:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"Überprüfen, ob das Modell verfügbar ist
openclaw models list --provider anthropicKonfigurationsbeispiel
{ env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" }, agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}Claude CLI
Am besten geeignet für: Wiederverwendung einer vorhandenen Claude-CLI-Anmeldung ohne separaten API-Schlüssel.
Sicherstellen, dass Claude CLI installiert und angemeldet ist
Prüfen Sie dies mit:
claude --versionOnboarding ausführen
openclaw onboard# choose: Claude CLIOpenClaw erkennt die vorhandenen Claude-CLI-Anmeldedaten und verwendet sie wieder.
Überprüfen, ob das Modell verfügbar ist
openclaw models list --provider anthropicKonfigurationsbeispiel
Bevorzugen Sie die kanonische Anthropic-Modellreferenz plus eine CLI-Laufzeitüberschreibung:
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" }, models: { "anthropic/claude-opus-4-8": { agentRuntime: { id: "claude-cli" }, }, }, }, },}Legacy-Modellreferenzen wie claude-cli/claude-opus-4-7 funktionieren aus
Kompatibilitätsgründen weiterhin, neue Konfigurationen sollten die Provider-/Modellauswahl jedoch als
anthropic/* beibehalten und das Ausführungs-Backend in der Provider-/Modell-Laufzeitrichtlinie festlegen.
Abrechnung und claude -p
OpenClaw verwendet den nicht interaktiven claude -p-Pfad von Claude Code für Claude-CLI-
Ausführungen. Anthropic behandelt diesen Pfad derzeit als Agent-SDK-/programmatische Nutzung:
- Das Support-Update von Anthropic vom 15. Juni 2026 hat den zuvor angekündigten separaten Agent-SDK-Guthabenplan pausiert.
- Derzeit werden Claude Agent SDK,
claude -pund die Nutzung von Drittanbieter- Apps in Abonnementplänen weiterhin auf die Nutzungslimits des angemeldeten Abonnements angerechnet. - Das zuvor angekündigte monatliche Agent-SDK-Guthaben ist nicht verfügbar, während Anthropic diesen Plan überarbeitet.
- Console-/API-Schlüssel-Anmeldungen verwenden Pay-as-you-go-API-Abrechnung und erhalten nicht das Agent-SDK-Guthaben des Abonnements.
Weitere Informationen zur Pausenmitteilung finden Sie im Agent-SDK-Planartikel von Anthropic und zum Abonnementverhalten in den Claude Code-Planartikeln für Pro/Max und Team/Enterprise.
Anthropic kann die Abrechnung und das Rate-Limit-Verhalten von Claude Code ohne
OpenClaw-Release ändern. Prüfen Sie claude auth status, /status und
die verlinkten Dokumente von Anthropic, wenn planbare Abrechnung wichtig ist.
Thinking-Standards (Claude Fable 5, 4.8 und 4.6)
anthropic/claude-fable-5 verwendet immer adaptives Thinking und setzt standardmäßig
den Aufwand auf high. Da Anthropic nicht erlaubt, Thinking für dieses Modell zu deaktivieren,
verwenden /think off und /think minimal den Aufwand low. OpenClaw lässt außerdem benutzerdefinierte
Temperaturwerte für Fable-5-Anfragen weg.
Claude Opus 4.8 lässt Thinking in OpenClaw standardmäßig deaktiviert. Wenn Sie adaptives Thinking explizit mit /think high|xhigh|max aktivieren, sendet OpenClaw die Opus-4.8-Aufwandswerte von Anthropic; Claude-4.6-Modelle verwenden standardmäßig adaptive.
Überschreiben Sie dies pro Nachricht mit /think:<level> oder in den Modellparametern:
{ agents: { defaults: { models: { "anthropic/claude-opus-4-8": { params: { thinking: "high" }, }, }, }, },}Fallback bei Sicherheitsablehnung (Claude Fable 5)
Warum dies existiert
Fable-5-Klassifikatoren geben stop_reason: "refusal" bei Anfragen in eingeschränkten
Domänen zurück, und sie erzeugen außerdem False Positives bei angrenzend unbedenklicher Arbeit (Sicherheits-
Tools, Life Sciences oder sogar die Aufforderung an das Modell, seine rohe
Argumentation wiederzugeben). Ohne Fallback schlägt die Runde mit einem Fehler fehl, obwohl
ein anderes Claude-Modell sie problemlos bedienen würde — die eigene Ablehnungsnachricht von Anthropic
weist API-Integratoren an, ein Fallback-Modell zu konfigurieren.
Funktionsweise
- Für jede direkte API-Schlüssel-Anfrage an
anthropic/claude-fable-5sendet OpenClaw Anthropics serverseitige Fallback-Aktivierung: den Beta-Headerserver-side-fallback-2026-06-01plusfallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 ist das einzige Fallback-Ziel, das Anthropic für Fable 5 erlaubt. - Nur eine Ablehnung durch einen Sicherheitsklassifikator löst den Fallback aus. Rate Limits, Überlastungen und Serverfehler verhalten sich exakt wie zuvor und laufen über OpenClaws normalen Modell-Failover.
- Die Rettung erfolgt innerhalb desselben Aufrufs. Eine Ablehnung vor jeder Ausgabe ist bis auf die Latenz unsichtbar; die gesamte Antwort stammt von Opus 4.8. Bei einer Ablehnung mitten im Stream wird der Teiltext als Präfix beibehalten, ab dem das Fallback- Modell fortsetzt, während die Argumentation und Tool-Aufrufe des abgelehnten Modells gemäß den Replay-Regeln von Anthropic verworfen werden (sie dürfen nicht zurückgegeben oder ausgeführt werden).
- Wenn Claude Opus 4.8 ebenfalls ablehnt, zeigt die Runde die Ablehnung als Fehler an, exakt wie vor dieser Funktion.
Der Fallback erfolgt auf Ebene der Anthropic API, daher muss claude-opus-4-8 nicht
in Ihrer konfigurierten Modellliste oder Fallback-Kette enthalten sein — ein Fable-fähiger
API-Schlüssel kann Opus immer bedienen.
Beobachtbarkeit und Abrechnung
- Eine per Fallback bediente Runde zeichnet eine
provider_fallback-Diagnose in der Assistentennachricht auf, diefromModelundtoModelbenennt, und dasresponseModelder Nachricht meldetclaude-opus-4-8. - Anthropic rechnet pro Versuch ab: Eine Ablehnung vor der Ausgabe ist kostenlos, und die Rettung wird zu Claude-Opus-4.8-Tarifen abgerechnet (derzeit die Hälfte der Fable-5-Tarife). OpenClaws Kostenschätzung pro Runde bepreist per Fallback bediente Runden entsprechend mit Opus-Tarifen.
- Eine Ablehnung mitten im Stream berechnet zusätzlich den bereits gestreamten Fable-Teil auf Anthropic-Seite; dieser Anteil wird in der nutzungsbasierten Aufschlüsselung pro Versuch der API gemeldet, aber nicht in OpenClaws Kostenschätzung pro Runde eingerechnet.
Geltungsbereich
Gilt für anthropic/claude-fable-5 mit API-Schlüssel-Authentifizierung gegen
api.anthropic.com. OAuth (Wiederverwendung eines Claude-CLI-Abonnements), Proxy-Basis-URLs,
Bedrock-, Vertex- und Foundry-Anfragen bleiben unverändert und zeigen dort weiterhin
Ablehnungen als Fehler an.
Live verifiziert: Ein unbedenklicher Prompt, der Fable 5 auffordert, seine rohe Chain of
Thought wiederzugeben, wird ohne Fallbacks mit category: "reasoning_extraction" abgelehnt,
und derselbe Prompt über OpenClaw gibt eine normale von Opus bediente
Antwort mit angehängter provider_fallback-Diagnose zurück.
Siehe Anthropics Leitfaden zu Ablehnungen und Fallback für das zugrunde liegende Verhalten.
Prompt-Caching
OpenClaw unterstützt die Prompt-Caching-Funktion von Anthropic für API-Schlüssel-Authentifizierung.
| Wert | Cache-Dauer | Beschreibung |
|---|---|---|
"short" (Standard) |
5 Minuten | Automatisch für API-Schlüssel-Authentifizierung angewendet |
"long" |
1 Stunde | Erweiterter Cache |
"none" |
Kein Caching | Prompt-Caching deaktivieren |
{ agents: { defaults: { models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, },}Cache-Überschreibungen pro Agent
Verwenden Sie Parameter auf Modellebene als Basis und überschreiben Sie dann bestimmte Agents über agents.list[].params:
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" }, models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, list: [ { id: "research", default: true }, { id: "alerts", params: { cacheRetention: "none" } }, ], },}Reihenfolge der Config-Zusammenführung:
agents.defaults.models["provider/model"].paramsagents.list[].params(passendeid, überschreibt nach Schlüssel)
Dadurch kann ein Agent einen langlebigen Cache behalten, während ein anderer Agent mit demselben Modell das Caching für stoßartigen Traffic mit geringer Wiederverwendung deaktiviert.
Bedrock-Claude-Hinweise
- Anthropic-Claude-Modelle auf Bedrock (
amazon-bedrock/*anthropic.claude*) akzeptierencacheRetentionals Pass-through, wenn es konfiguriert ist. - Nicht-Anthropic-Bedrock-Modelle werden zur Laufzeit auf
cacheRetention: "none"erzwungen. - Intelligente Standardwerte für API-Schlüssel setzen außerdem
cacheRetention: "short"für Claude-on-Bedrock-Refs, wenn kein expliziter Wert festgelegt ist.
Erweiterte Konfiguration
Schneller Modus
Der gemeinsame /fast-Schalter von OpenClaw unterstützt direkten Anthropic-Traffic (API-Schlüssel und OAuth zu api.anthropic.com).
| Befehl | Wird abgebildet auf |
|---|---|
/fast on |
service_tier: "auto" |
/fast off |
service_tier: "standard_only" |
{ agents: { defaults: { models: { "anthropic/claude-sonnet-4-6": { params: { fastMode: true }, }, }, }, },}Medienverständnis (Bild und PDF)
Das gebündelte Anthropic-Plugin registriert Bild- und PDF-Verständnis. OpenClaw löst Medienfunktionen automatisch aus der konfigurierten Anthropic-Authentifizierung auf — es ist keine zusätzliche Config erforderlich.
| Eigenschaft | Wert |
|---|---|
| Standardmodell | claude-opus-4-8 |
| Unterstützte Eingabe | Bilder, PDF-Dokumente |
Wenn ein Bild oder eine PDF an eine Unterhaltung angehängt wird, leitet OpenClaw sie automatisch über den Anthropic-Provider für Medienverständnis.
1M-Kontextfenster
Anthropic's 1M-Kontextfenster ist für GA-fähige Claude-4.x-Modelle wie Opus 4.8, Opus 4.7, Opus 4.6 und Sonnet 4.6 verfügbar. OpenClaw dimensioniert diese Modelle automatisch auf 1M:
{ agents: { defaults: { models: { "anthropic/claude-opus-4-6": {}, }, }, },}Ältere Configs können params.context1m: true beibehalten, aber OpenClaw sendet den
ausgemusterten Beta-Header context-1m-2025-08-07 nicht mehr. Ältere anthropicBeta-Config-
Einträge mit diesem Wert werden bei der Auflösung der Anfrage-Header ignoriert, und
nicht unterstützte ältere Claude-Modelle bleiben bei ihrem normalen Kontextfenster.
params.context1m: true gilt außerdem für das Claude-CLI-Backend
(claude-cli/*) für berechtigte GA-fähige Opus- und Sonnet-Modelle und erhält
das Laufzeit-Kontextfenster für diese CLI-Sitzungen, damit es dem Verhalten der direkten API
entspricht.
Claude Opus 4.8 1M-Kontext
anthropic/claude-opus-4-8 und seine claude-cli-Variante haben standardmäßig ein 1M-Kontextfenster — kein params.context1m: true erforderlich.
Fehlerbehebung
401-Fehler / Token plötzlich ungültig
Anthropic-Token-Authentifizierung läuft ab und kann widerrufen werden. Verwenden Sie für neue Setups stattdessen einen Anthropic-API-Schlüssel.
Kein API-Schlüssel für Provider "anthropic" gefunden
Anthropic-Authentifizierung ist pro Agent — neue Agents übernehmen die Schlüssel des Haupt-Agents nicht. Führen Sie das Onboarding für diesen Agent erneut aus (oder konfigurieren Sie einen API-Schlüssel auf dem Gateway-Host), und prüfen Sie anschließend mit openclaw models status.
Keine Zugangsdaten 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 konfigurieren Sie einen API-Schlüssel für diesen Profilpfad.
Kein verfügbares Authentifizierungsprofil (alle in Abklingzeit)
Prüfen Sie openclaw models status --json auf auth.unusableProfiles. Anthropic-Rate-Limit-Abklingzeiten können modellspezifisch sein, daher kann ein verwandtes Anthropic-Modell weiterhin verwendbar sein. Fügen Sie ein weiteres Anthropic-Profil hinzu, oder warten Sie auf die Abklingzeit.
Verwandte Themen
Provider, Modell-Refs und Failover-Verhalten auswählen.
Einrichtung und Laufzeitdetails des Claude-CLI-Backends.
Wie Prompt-Caching Provider-übergreifend funktioniert.
Authentifizierungsdetails und Regeln für die Wiederverwendung von Zugangsdaten.