- 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
- Claude CLI
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.
Konfigurationsbeispiel
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:
Zugehörige Anthropic-Dokumente:
Fallback bei Sicherheitsablehnung (Claude Fable 5)
Warum dies existiert
Fable-5-Klassifikatoren gebenstop_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.
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üranthropic/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 |
Cache-Überschreibungen pro Agent
Cache-Überschreibungen pro Agent
Verwenden Sie Parameter auf Modellebene als Basis und überschreiben Sie dann bestimmte Agents über Reihenfolge der Config-Zusammenführung:
agents.list[].params:agents.defaults.models["provider/model"].paramsagents.list[].params(passendeid, überschreibt nach Schlüssel)
Bedrock-Claude-Hinweise
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
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" |
- Wird nur für direkte
api.anthropic.com-Anfragen injiziert. Proxy-Routen lassenservice_tierunverändert. - Explizite
serviceTier- oderservice_tier-Parameter überschreiben/fast, wenn beide gesetzt sind. - Bei Konten ohne Priority-Tier-Kapazität kann
service_tier: "auto"zustandardaufgelöst werden.
Medienverständnis (Bild und PDF)
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.
Wenn ein Bild oder eine PDF an eine Unterhaltung angehängt wird, leitet OpenClaw sie automatisch
über den Anthropic-Provider für Medienverständnis.
| Eigenschaft | Wert |
|---|---|
| Standardmodell | claude-opus-4-8 |
| Unterstützte Eingabe | Bilder, PDF-Dokumente |
1M-Kontextfenster
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:Ä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
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
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
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
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)
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.Weitere Hilfe: Fehlerbehebung und FAQ.
Verwandte Themen
Modellauswahl
Provider, Modell-Refs und Failover-Verhalten auswählen.
CLI-Backends
Einrichtung und Laufzeitdetails des Claude-CLI-Backends.
Prompt-Caching
Wie Prompt-Caching Provider-übergreifend funktioniert.
OAuth und Authentifizierung
Authentifizierungsdetails und Regeln für die Wiederverwendung von Zugangsdaten.