Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Anthropic entwickelt die Claude-Modellfamilie. OpenClaw unterstützt zwei Authentifizierungswege:
  • API-Schlüssel — direkter Anthropic-API-Zugriff mit nutzungsbasierter Abrechnung (anthropic/*-Modelle)
  • Claude CLI — eine vorhandene Claude CLI-Anmeldung auf demselben Host wiederverwenden
Anthropic-Mitarbeitende haben uns mitgeteilt, dass die OpenClaw-artige Nutzung der Claude CLI wieder erlaubt ist, daher behandelt OpenClaw die Wiederverwendung der Claude CLI und die Nutzung von claude -p als genehmigt, sofern Anthropic keine neue Richtlinie veröffentlicht.Für langlebige Gateway-Hosts bleiben Anthropic-API-Schlüssel weiterhin der klarste und vorhersehbarste Produktionspfad.Aktuelle öffentliche Anthropic-Dokumentation:

Erste Schritte

Am besten geeignet für: Standard-API-Zugriff und nutzungsbasierte Abrechnung.
1

API-Schlüssel abrufen

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

Onboarding ausführen

openclaw onboard
# choose: Anthropic API key
Oder übergeben Sie den Schlüssel direkt:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

Verfügbarkeit des Modells prüfen

openclaw models list --provider anthropic

Konfigurationsbeispiel

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

Thinking-Standardwerte (Claude 4.6)

Claude 4.6-Modelle verwenden in OpenClaw standardmäßig adaptive Thinking, wenn keine explizite Thinking-Stufe gesetzt ist. Überschreiben Sie dies pro Nachricht mit /think:<level> oder in Modellparametern:
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { thinking: "adaptive" },
        },
      },
    },
  },
}
Zugehörige Anthropic-Dokumentation:

Prompt-Caching

OpenClaw unterstützt Anthropics Prompt-Caching-Funktion für Authentifizierung per API-Schlüssel.
WertCache-DauerBeschreibung
"short" (Standard)5 MinutenWird für API-Schlüssel-Authentifizierung automatisch angewendet
"long"1 StundeErweiterter Cache
"none"Kein CachingPrompt-Caching deaktivieren
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
Verwenden Sie Modellparameter als Basis und überschreiben Sie anschließend 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 beim Zusammenführen der Konfiguration:
  1. agents.defaults.models["provider/model"].params
  2. agents.list[].params (passende id, Überschreibung nach Schlüssel)
Dadurch kann ein Agent einen langlebigen Cache behalten, während ein anderer Agent auf demselben Modell das Caching für stoßartigen Traffic mit geringer Wiederverwendung deaktiviert.
  • Anthropic Claude-Modelle auf Bedrock (amazon-bedrock/*anthropic.claude*) akzeptieren konfiguriert eine cacheRetention-Durchleitung.
  • Nicht-Anthropic-Bedrock-Modelle werden zur Laufzeit auf cacheRetention: "none" gezwungen.
  • Intelligente Standardwerte für API-Schlüssel setzen außerdem cacheRetention: "short" für Claude-on-Bedrock-Referenzen, wenn kein expliziter Wert festgelegt ist.

Erweiterte Konfiguration

Der gemeinsame /fast-Schalter von OpenClaw unterstützt direkten Anthropic-Traffic (API-Schlüssel und OAuth zu api.anthropic.com).
BefehlWird zugeordnet zu
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • Wird nur für direkte Anfragen an api.anthropic.com injiziert. Proxy-Routen lassen service_tier unverändert.
  • Explizite serviceTier- oder service_tier-Parameter überschreiben /fast, wenn beide gesetzt sind.
  • Bei Konten ohne Priority-Tier-Kapazität kann service_tier: "auto" zu standard aufgelöst werden.
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 Konfiguration erforderlich.
EigenschaftWert
Standardmodellclaude-opus-4-7
Unterstützte EingabeBilder, 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 weiter.
Anthropics 1M-Kontextfenster ist Beta-gesteuert. Aktivieren Sie es pro Modell:
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true },
        },
      },
    },
  },
}
OpenClaw ordnet dies bei Anfragen anthropic-beta: context-1m-2025-08-07 zu.params.context1m: true gilt auch für das Claude CLI-Backend (claude-cli/*) für berechtigte Opus- und Sonnet-Modelle und erweitert das Laufzeit- Kontextfenster dieser CLI-Sitzungen so, dass es dem direkten API-Verhalten entspricht.
Erfordert Langkontextzugriff für Ihre Anthropic-Anmeldedaten. Legacy-Token-Authentifizierung (sk-ant-oat-*) wird für 1M-Kontextanfragen abgelehnt — OpenClaw protokolliert eine Warnung und fällt auf das Standard-Kontextfenster zurück.
anthropic/claude-opus-4.7 und seine claude-cli-Variante haben standardmäßig ein 1M-Kontextfenster — kein params.context1m: true erforderlich.

Fehlerbehebung

Anthropic-Token-Authentifizierung läuft ab und kann widerrufen werden. Verwenden Sie für neue Einrichtungen stattdessen einen Anthropic-API-Schlüssel.
Anthropic-Authentifizierung ist pro Agent — neue Agents erben 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.
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.
Prüfen Sie openclaw models status --json auf auth.unusableProfiles. Anthropic-Rate-Limit-Cooldowns können modellspezifisch sein, daher kann ein benachbartes Anthropic-Modell weiterhin nutzbar sein. Fügen Sie ein weiteres Anthropic-Profil hinzu oder warten Sie den Cooldown ab.
Weitere Hilfe: Fehlerbehebung und FAQ.

Verwandt

Modellauswahl

Provider, Modellreferenzen und Failover-Verhalten auswählen.

CLI-Backends

Einrichtung des Claude CLI-Backends und Laufzeitdetails.

Prompt-Caching

Wie Prompt-Caching über Provider hinweg funktioniert.

OAuth und Authentifizierung

Authentifizierungsdetails und Regeln zur Wiederverwendung von Anmeldedaten.