Providers

Anthropic

Anthropic entwickelt die Claude-Modellfamilie. OpenClaw unterstützt zwei Authentifizierungswege:

  • API-Schlüssel – direkter Zugriff auf die Anthropic-API mit nutzungsbasierter Abrechnung (anthropic/*-Modelle)
  • Claude CLI – eine vorhandene Claude-Code-Anmeldung auf demselben Host wiederverwenden

Nutzungs- und Kostenverfolgung

OpenClaw erkennt die verfügbaren Anthropic-Anmeldedaten und wählt die passende Nutzungsansicht aus:

  • Anmeldedaten für Claude-Abonnements bzw. die Einrichtung zeigen Kontingentzeiträume und ein optionales Budget für zusätzliche Nutzung an.
  • ANTHROPIC_ADMIN_KEY oder ANTHROPIC_ADMIN_API_KEY zeigt in der Control UI unter Nutzung 30 Tage der vom Provider gemeldeten Organisationskosten und Messages-API-Nutzung an, einschließlich täglicher Ausgaben, Token-/Cache-Gesamtsummen, meistgenutzter Modelle und Kostenkategorien.
  • In einem Anthropic-Providerprofil gespeicherte sk-ant-admin...-Anmeldedaten werden automatisch als Admin-API-Schlüssel erkannt.

Der Kostenverlauf der Admin API stammt aus der Nutzungs- und Kosten-API von Anthropic. Dabei handelt es sich um die tatsächliche Abrechnung des Providers, getrennt von den aus OpenClaw-Sitzungen abgeleiteten geschätzten Kosten.

Erste Schritte

API-Schlüssel

Am besten geeignet für: standardmäßigen API-Zugriff und nutzungsbasierte Abrechnung.

  • API-Schlüssel abrufen

    Erstellen Sie in der Anthropic Console einen API-Schlüssel.

  • Onboarding ausführen

    bash
    openclaw onboard# auswählen: Anthropic-API-Schlüssel

    Alternativ können Sie den Schlüssel direkt übergeben:

    bash
    openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
  • Verfügbarkeit des Modells überprüfen

    bash
    openclaw models list --provider anthropic
  • Konfigurationsbeispiel

    json5
    {  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: die Wiederverwendung einer vorhandenen Claude-CLI-Anmeldung ohne separaten API-Schlüssel.

  • Sicherstellen, dass Claude CLI installiert und angemeldet ist

    Überprüfen Sie dies mit:

    bash
    claude --version
  • Onboarding ausführen

    bash
    openclaw onboard# auswählen: Claude CLI

    OpenClaw erkennt die vorhandenen Claude-CLI-Anmeldedaten und verwendet sie wieder.

  • Verfügbarkeit des Modells überprüfen

    bash
    openclaw models list --provider anthropic
  • Konfigurationsbeispiel

    Verwenden Sie vorzugsweise die kanonische Anthropic-Modellreferenz zusammen mit einer CLI-Laufzeitüberschreibung:

    json5
    {  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-8" },      models: {        "anthropic/claude-opus-4-8": {          agentRuntime: { id: "claude-cli" },        },      },    },  },}

    Veraltete Modellreferenzen vom Typ 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 für Claude-CLI-Ausführungen den nicht interaktiven claude -p-Pfad von Claude Code. Anthropic behandelt diesen Pfad derzeit als Agent-SDK- bzw. programmatische Nutzung:

    • Mit dem Support-Update vom 15. Juni 2026 setzte Anthropic den zuvor angekündigten separaten Agent-SDK-Guthabenplan aus.
    • Die Nutzung von Claude Agent SDK, claude -p und Drittanbieter-Apps mit einem Abonnementtarif wird 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.
    • Anmeldungen über die Console bzw. mit API-Schlüssel verwenden eine nutzungsbasierte API-Abrechnung und erhalten kein Agent-SDK-Guthaben des Abonnements.

    Den Hinweis zur Aussetzung finden Sie im Artikel zum Agent-SDK-Tarif von Anthropic. Informationen zum Verhalten der Abonnements finden Sie in den Claude-Code-Tarifartikeln für Pro/Max und Team/Enterprise.

    Anthropic kann die Abrechnung und das Ratenbegrenzungsverhalten von Claude Code ohne eine OpenClaw-Veröffentlichung ändern. Prüfen Sie claude auth status, /status und die verlinkte Dokumentation von Anthropic, wenn eine vorhersehbare Abrechnung wichtig ist.

    Claude-Sitzungen auf mehreren Computern

    Das gebündelte Anthropic-Plugin fügt der normalen Sitzungsseitenleiste eine Gruppe Claude Code hinzu. Zeilen werden im normalen Chat-Bereich geöffnet. Es erkennt nicht archivierte Claude-Code-Sitzungen auf dem Gateway und auf verbundenen Node-Hosts:

    • Claude-CLI-Sitzungen stammen aus gültigen Projektindex-Datensätzen und aktuellen JSONL-Dateien, deren begrenztes Metadatenpräfix eine Nicht-Sidechain-Sitzung vom Typ sdk-cli unter ~/.claude/projects/ identifiziert.
    • Claude-Desktop-Sitzungen verwenden den Desktop-Titel, die Aktivitätszeit und den Archivstatus, wenn ihre Metadaten auf dieselbe Claude-Code-Sitzungs-ID verweisen.
    • Eine ausschließlich über die CLI bestehende Sitzung besitzt kein Archivkennzeichen und bleibt daher sichtbar, solange ihr Transkript vorhanden ist.

    Es ist keine zusätzliche OpenClaw-Konfiguration erforderlich. Das Anthropic-Plugin ist gebündelt und standardmäßig aktiviert; eine native macOS-Node kündigt die schreibgeschützten Claude-Sitzungsbefehle an, wenn das lokale Verzeichnis ~/.claude/projects/ vorhanden ist. Genehmigen Sie das Upgrade der Node-Kopplung, wenn diese Befehle erstmals angezeigt werden.

    Die Seitenleiste beginnt mit der neuesten begrenzten Seite jedes Hosts und wird im normalen 30-Sekunden-Takt aktualisiert. Verwenden Sie unterhalb einer Kataloggruppe Weitere Sitzungen laden, um für jeden Host mit weiterem Verlauf die nächste Seite anzuhängen; angehängte Zeilen bleiben sichtbar und werden bei Aktualisierungen erneut bis zur gleichen Tiefe abgerufen. Katalogclients verwenden sessions.catalog.list; beim Öffnen einer Zeile wird sessions.catalog.read verwendet.

    Beim Auswählen einer Zeile wird zuerst die neueste Transkriptseite gelesen. Ältere Transkripteinträge laden folgt einem undurchsichtigen Byte-Cursor und liest einen weiteren begrenzten Abschnitt aus der JSONL-Datei, anstatt den gesamten Verlauf zu laden. Normale Inhalte von Benutzern, Assistenten, Reasoning, Tool-Aufrufen und Tool-Ergebnissen bleiben erhalten. Ein einzelner Eintrag, der größer als die Sicherheitsobergrenze der Node bzw. des Gateways ist, wird eindeutig als abgeschnitten gekennzeichnet.

    Wenn Sie in einer Gateway-lokalen claude-cli-Zeile Text in den normalen Eingabebereich eingeben, wird sessions.catalog.continue aufgerufen. OpenClaw löst den lokalen Katalogdatensatz erneut auf, erstellt eine modellgebundene native Sitzung oder verwendet sie wieder, importiert höchstens 200 sichtbare Einträge oder 512 KiB und initialisiert die Claude-CLI-Bindung. Der erste Durchlauf wird mit --fork-session fortgesetzt; Claude weist der Abspaltung eine neue Sitzungs-ID zu, sodass spätere Durchläufe die Abspaltung verwenden und die Quellsitzung unverändert bleibt. Zeilen von Claude Desktop und gekoppelten Nodes sind schreibgeschützt.

    Weitere Informationen zum Node-Befehl und zur Sicherheitsgrenze finden Sie unter Nodes: Claude-Sitzungen und Transkripte.

    Standardwerte für Thinking (Claude Sonnet 5, Mythos 5, Fable 5, 4.8 und 4.6)

    anthropic/claude-sonnet-5 verwendet standardmäßig adaptives Thinking mit dem Aufwand high. Verwenden Sie /think off, um Thinking zu deaktivieren, oder /think xhigh|max für die höheren nativen Aufwandsstufen des Modells. OpenClaw lässt manuelle Thinking-Budgets, benutzerdefinierte Sampling-Parameter, Assistenten-Prefills und Priority Tier für Sonnet 5 aus, da Anthropic diese Anfragefunktionen bei diesem Modell nicht unterstützt. Der Katalog verwendet bis zum 31. August 2026 die Einführungspreise von Anthropic in Höhe von $2/$10 für Ein-/Ausgabe; die Standardpreise von $3/$15 gelten ab dem 1. September 2026.

    anthropic/claude-fable-5 verwendet immer adaptives Thinking und standardmäßig den Aufwand high. Anthropic lässt bei diesem Modell keine Deaktivierung von Thinking zu, daher werden /think off und /think minimal stattdessen dem Aufwand low zugeordnet. OpenClaw lässt außerdem benutzerdefinierte Temperaturwerte für Fable-5-Anfragen aus, da Anthropic eine Temperaturüberschreibung bei jeder Anfrage mit aktiviertem Thinking ablehnt.

    anthropic/claude-mythos-5 ist ein Modell mit eingeschränktem Zugriff und demselben Vertrag für dauerhaft aktiviertes adaptives Thinking. OpenClaw verwendet standardmäßig high, ordnet /think off und /think minimal low zu und lässt vom Aufrufer ausgewählte Sampling-Parameter aus. Der Katalog veröffentlicht sein Kontextfenster mit 1.000.000 Token, sein Ausgabelimit von 128.000 Token, die Bildeingabe und die Ein-/Ausgabepreise von $10/$50.

    Bei Claude Opus 4.8 ist Thinking in OpenClaw standardmäßig deaktiviert. Wenn Sie adaptives Thinking ausdrücklich mit /think high|xhigh|max aktivieren, sendet OpenClaw die Aufwandswerte von Anthropic für Opus 4.8; Claude-4.6-Modelle (Opus 4.6 und Sonnet 4.6) verwenden standardmäßig adaptive.

    Überschreiben Sie dies pro Nachricht mit /think:<level> oder in den Modellparametern:

    json5
    {  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-8": {          params: { thinking: "high" },        },      },    },  },}

    Fallback bei sicherheitsbedingter Ablehnung (Claude Fable 5)

    Warum dies existiert

    Die Klassifikatoren von Fable 5 geben bei Anfragen in eingeschränkten Bereichen stop_reason: "refusal" zurück und erzeugen außerdem Fehlalarme bei harmlosen, angrenzenden Aufgaben (Sicherheitstools, Biowissenschaften oder sogar bei der Aufforderung an das Modell, seine unverarbeiteten Gedankengänge wiederzugeben). Ohne Fallback endet die Anfrage mit einem Fehler, obwohl ein anderes Claude-Modell sie problemlos bearbeiten könnte – Anthropic weist API-Integratoren in der eigenen Ablehnungsmeldung darauf hin, ein Fallback-Modell zu konfigurieren.

    Funktionsweise

    1. Bei jeder direkten Anfrage mit API-Schlüssel an anthropic/claude-fable-5 sendet OpenClaw die serverseitige Fallback-Einwilligung von Anthropic: den Beta-Header server-side-fallback-2026-06-01 sowie fallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 ist das einzige Fallback-Ziel, das Anthropic für Fable 5 zulässt.
    2. Nur eine Ablehnung durch den Sicherheitsklassifikator löst den Fallback aus. Ratenbegrenzungen, Überlastungen und Serverfehler verhalten sich unverändert und durchlaufen den normalen Modell-Failover von OpenClaw.
    3. Die Wiederherstellung erfolgt innerhalb desselben Aufrufs. Eine Ablehnung vor jeglicher Ausgabe ist abgesehen von der Latenz nicht sichtbar; die gesamte Antwort stammt von Opus 4.8. Bei einer Ablehnung während des Streams bleibt der unvollständige Text als Präfix erhalten, ab dem das Fallback-Modell fortfährt, während die Gedankengänge und Tool-Aufrufe des ablehnenden Modells gemäß den Wiedergaberegeln von Anthropic verworfen werden (sie dürfen weder zurückgegeben noch ausgeführt werden).
    4. Wenn auch Claude Opus 4.8 ablehnt, wird die Ablehnung wie vor dieser Funktion als Fehler für die Anfrage ausgegeben.

    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 verwenden.

    Beobachtbarkeit und Abrechnung

    • Eine per Fallback bearbeitete Anfrage zeichnet in der Assistant-Nachricht eine provider_fallback-Diagnose auf, die fromModel und toModel benennt, und responseModel der Nachricht meldet claude-opus-4-8.
    • Anthropic rechnet pro Versuch ab: Eine Ablehnung vor der Ausgabe ist kostenlos, und die Wiederherstellung wird zu den Tarifen von Claude Opus 4.8 abgerechnet (derzeit halb so hoch wie die Tarife von Fable 5). Die Kostenschätzung von OpenClaw pro Anfrage berechnet per Fallback bearbeitete Anfragen entsprechend zu Opus-Tarifen.
    • Bei einer Ablehnung während des Streams stellt Anthropic zusätzlich den bereits gestreamten unvollständigen Fable-Teil in Rechnung; dieser Anteil wird in der verbrauchsbezogenen Aufschlüsselung pro Versuch der API ausgewiesen, fließt jedoch nicht in die Schätzung von OpenClaw pro Anfrage ein.

    Geltungsbereich

    Gilt für anthropic/claude-fable-5 mit API-Schlüssel-Authentifizierung gegenüber api.anthropic.com. OAuth (Wiederverwendung eines Claude-CLI-Abonnements), Proxy-Basis-URLs, Bedrock-, Vertex- und Foundry-Anfragen bleiben unverändert und geben Ablehnungen dort weiterhin als Fehler aus.

    Live verifiziert: Eine harmlose Aufforderung an Fable 5, seine unverarbeitete Gedankenkette wiederzugeben, wird ohne Fallbacks mit category: "reasoning_extraction" abgelehnt. Dieselbe Aufforderung über OpenClaw liefert eine normale, von Opus bearbeitete Antwort mit angehängter provider_fallback-Diagnose.

    Informationen zum zugrunde liegenden Verhalten finden Sie im Anthropic-Leitfaden zu Ablehnungen und Fallbacks.

    Prompt-Caching

    OpenClaw unterstützt die Prompt-Caching-Funktion von Anthropic für die Authentifizierung per API-Schlüssel.

    Wert Cache-Dauer Beschreibung
    "short" (Standard) 5 Minuten Wird bei Authentifizierung per API-Schlüssel automatisch angewendet
    "long" 1 Stunde Erweiterter Cache
    "none" Kein Caching Prompt-Caching deaktivieren
    json5
    {  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },  },}
    Agent-spezifische Cache-Überschreibungen

    Verwenden Sie Parameter auf Modellebene als Grundlage und überschreiben Sie anschließend bestimmte Agenten über agents.list[].params:

    json5
    {  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 Konfigurationszusammenführung:

    1. agents.defaults.models["provider/model"].params
    2. agents.list[].params (übereinstimmende id, Überschreibung nach Schlüssel)

    Dadurch kann ein Agent einen langlebigen Cache behalten, während ein anderer Agent mit demselben Modell das Caching für stark schwankenden Datenverkehr mit geringer Wiederverwendung deaktiviert.

    Hinweise zu Claude auf Bedrock
    • Anthropic-Claude-Modelle auf Bedrock (amazon-bedrock/*anthropic.claude*) akzeptieren bei entsprechender Konfiguration die Durchleitung von cacheRetention.
    • Bei Bedrock-Modellen, die nicht von Anthropic stammen, wird cacheRetention: "none" zur Laufzeit erzwungen.
    • Intelligente Standardwerte für API-Schlüssel setzen auch für Claude-on-Bedrock-Referenzen cacheRetention: "short", wenn kein expliziter Wert festgelegt ist.

    Erweiterte Konfiguration

    Schnellmodus

    Der gemeinsame /fast-Umschalter von OpenClaw setzt das Anthropic-Feld service_tier für direkte Anfragen mit API-Schlüssel an api.anthropic.com.

    Befehl Entspricht
    /fast on service_tier: "auto"
    /fast off service_tier: "standard_only"
    json5
    {  agents: {    defaults: {      models: {        "anthropic/claude-sonnet-4-6": {          params: { fastMode: true },        },      },    },  },}
    Medienerkennung (Bilder und PDF)

    Das gebündelte Anthropic-Plugin registriert die Erkennung von Bildern und PDF-Dokumenten. OpenClaw ermittelt die Medienfunktionen automatisch anhand der konfigurierten Anthropic-Authentifizierung; es ist keine zusätzliche Konfiguration erforderlich.

    Eigenschaft Wert
    Standardmodell claude-opus-4-8
    Unterstützte Eingabe Bilder, PDF-Dokumente

    Wenn einer Unterhaltung ein Bild oder PDF-Dokument angehängt wird, leitet OpenClaw es automatisch über den Anthropic-Provider für Medienerkennung weiter.

    1M-Kontextfenster

    Claude Sonnet 5, Mythos 5 und Fable 5 verfügen über ein Eingabefenster von exakt 1.000.000 Token und unterstützen bis zu 128.000 Ausgabe-Token. Das 1M-Kontextfenster von Anthropic ist außerdem für Claude-4.x-Modelle mit adaptivem Denken allgemein verfügbar: Opus 4.8, Opus 4.7, Opus 4.6 und Sonnet 4.6. OpenClaw dimensioniert diese Modelle automatisch; params.context1m ist nicht erforderlich:

    json5
    {  agents: {    defaults: {      models: {        "anthropic/claude-sonnet-5": {},        "anthropic/claude-mythos-5": {},        "anthropic/claude-opus-4-6": {},      },    },  },}

    Ältere Konfigurationen können params.context1m: true beibehalten; für diese Modelle ist dies eine wirkungslose, aber unschädliche Einstellung, und OpenClaw sendet den eingestellten Beta-Header context-1m-2025-08-07 unabhängig davon nicht mehr. Ältere anthropicBeta-Konfigurationseinträge mit diesem Wert werden bei der Auflösung der Anfrage-Header entfernt, und nicht unterstützte ältere Claude-Modelle behalten ihr normales Kontextfenster.

    params.context1m: true verhält sich beim Claude-CLI-Backend (claude-cli/*) genauso: Geeignete, allgemein verfügbare Opus- und Sonnet-Modelle erhalten das 1M-Fenster bereits automatisch, sodass der Parameter auch dort optional ist.

    Claude Opus 4.8 mit 1M-Kontext

    anthropic/claude-opus-4-8 und dessen claude-cli-Variante verfügen standardmäßig über ein 1M-Kontextfenster; params.context1m: true ist nicht erforderlich.

    Fehlerbehebung

    401-Fehler / Token plötzlich ungültig

    Die Anthropic-Token-Authentifizierung läuft ab und kann widerrufen werden. Verwenden Sie für neue Einrichtungen stattdessen einen Anthropic-API-Schlüssel.

    Kein API-Schlüssel für Provider "anthropic" gefunden

    Die Anthropic-Authentifizierung erfolgt pro Agent; neue Agenten übernehmen die Schlüssel des Haupt-Agenten nicht. Führen Sie das Onboarding für diesen Agenten erneut durch (oder konfigurieren Sie einen API-Schlüssel auf dem Gateway-Host) und überprüfen Sie den Status 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 durch oder konfigurieren Sie einen API-Schlüssel für diesen Profilpfad.

    Kein verfügbares Authentifizierungsprofil (alle in Abklingzeit)

    Prüfen Sie auth.unusableProfiles mit openclaw models status --json. Abklingzeiten aufgrund von Anthropic-Ratenbegrenzungen können modellspezifisch sein, sodass ein anderes Anthropic-Modell möglicherweise weiterhin verwendbar ist. Fügen Sie ein weiteres Anthropic-Profil hinzu oder warten Sie, bis die Abklingzeit abgelaufen ist.

    Verwandte Themen

    Was this useful?
    On this page

    On this page