​

Anthropic (Claude)

​

Option A: Anthropic-API-Schlüssel

​

CLI-Einrichtung

openclaw onboard
# choose: Anthropic API key

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

​

Claude-CLI-Konfigurationsausschnitt

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

​

Standardwerte für Thinking (Claude 4.6)

• Anthropic-Claude-4.6-Modelle verwenden in OpenClaw standardmäßig adaptive thinking, wenn keine explizite Thinking-Stufe gesetzt ist.
• Sie können dies pro Nachricht (/think:<level>) oder in Modellparametern überschreiben: agents.defaults.models["anthropic/<model>"].params.thinking.
• Verwandte Anthropic-Dokumente:
  • Adaptive thinking
  • Extended thinking

​

Fast-Modus (Anthropic API)

• /fast on wird auf service_tier: "auto" abgebildet
• /fast off wird auf service_tier: "standard_only" abgebildet
• Konfigurationsstandard:

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

• OpenClaw fügt Anthropic-Service-Tiers nur für direkte api.anthropic.com-Anfragen ein. Wenn Sie anthropic/* über einen Proxy oder ein Gateway leiten, lässt /fast service_tier unverändert.
• Explizite Anthropic-Modellparameter serviceTier oder service_tier überschreiben den Standard von /fast, wenn beide gesetzt sind.
• Anthropic meldet den effektiven Tier in der Antwort unter usage.service_tier. Bei Konten ohne Priority-Tier-Kapazität kann service_tier: "auto" dennoch zu standard aufgelöst werden.

​

Prompt-Caching (Anthropic API)

​

Konfiguration

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

​

Standardwerte

​

cacheRetention-Überschreibungen pro Agent

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

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

​

Hinweise zu Bedrock Claude

• Anthropic-Claude-Modelle auf Bedrock (amazon-bedrock/*anthropic.claude*) akzeptieren konfiguriertes cacheRetention als Pass-through.
• Nicht-Anthropic-Bedrock-Modelle werden zur Laufzeit auf cacheRetention: "none" erzwungen.
• Die intelligenten Standardwerte für Anthropic-API-Schlüssel setzen auch cacheRetention: "short" für Claude-on-Bedrock-Modellreferenzen, wenn kein expliziter Wert gesetzt ist.

​

1M-Kontextfenster (Anthropic-Beta)

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

​

Option B: Claude CLI als Nachrichtenprovider

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

1. OpenClaw startet claude -p --output-format stream-json --include-partial-messages ... auf dem Gateway-Host und sendet den Prompt über stdin.
2. Der erste Turn sendet --session-id <uuid>.
3. Folge-Turns verwenden die gespeicherte Claude-Sitzung über --resume <sessionId> erneut.
4. Ihre Chat-Nachrichten laufen weiterhin durch die normale OpenClaw-Nachrichtenpipeline, aber die eigentliche Modellantwort wird von Claude CLI erzeugt.

​

Anforderungen

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

claude auth status

• OpenClaw lädt beim Gateway-Start automatisch das gebündelte Anthropic-Plugin, wenn Ihre Konfiguration explizit auf claude-cli/... oder die Backend-Konfiguration claude-cli verweist.

​

Konfigurationsausschnitt

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

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

​

Was Sie erhalten

• Wiederverwendete Claude-Abonnement-Authentifizierung aus der lokalen CLI (zur Laufzeit gelesen, nicht persistent gespeichert)
• Normales Nachrichten-/Sitzungsrouting von OpenClaw
• Kontinuität von Claude-CLI-Sitzungen über mehrere Turns hinweg (bei Authentifizierungsänderungen ungültig)
• Gateway-Tools, die Claude CLI über eine local loopback-MCP-Bridge bereitgestellt werden
• JSONL-Streaming mit Live-Fortschritt für partielle Nachrichten

​

Von Anthropic-Authentifizierung zu Claude CLI migrieren

• Claude CLI ist auf demselben Gateway-Host installiert, auf dem OpenClaw ausgeführt wird
• Claude CLI ist dort bereits angemeldet: claude auth login

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

openclaw onboard --auth-choice anthropic-cli

• prüft, dass Claude CLI auf dem Gateway-Host bereits angemeldet ist
• stellt das Standardmodell auf claude-cli/... um
• schreibt Anthropic-Standardmodell-Fallbacks wie anthropic/claude-opus-4-6 in claude-cli/claude-opus-4-6 um
• fügt passende claude-cli/...-Einträge zu agents.defaults.models hinzu

openclaw models status

• Ihre bestehenden Anthropic-Authentifizierungsprofile löschen
• jede alte anthropic/...-Konfigurationsreferenz außerhalb des Hauptpfads für Standardmodell/Allowlist entfernen

​

Wichtige Einschränkungen

• Dies ist nicht der Anthropic-API-Provider. Es ist die lokale CLI-Laufzeit.
• OpenClaw injiziert Tool-Aufrufe nicht direkt. Claude CLI erhält Gateway- Tools über eine local loopback-MCP-Bridge (bundleMcp: true, der Standard).
• Claude CLI streamt Antworten über JSONL (stream-json mit --include-partial-messages). Prompts werden über stdin gesendet, nicht über argv.
• Die Authentifizierung wird zur Laufzeit aus den aktiven Claude-CLI-Anmeldedaten gelesen und nicht in OpenClaw-Profilen gespeichert. Schlüsselbundabfragen werden in nicht interaktiven Kontexten unterdrückt.
• Die Wiederverwendung von Sitzungen wird über Metadaten in cliSessionBinding nachverfolgt. Wenn sich der Anmeldestatus von Claude CLI ändert (erneute Anmeldung, Token-Rotation), werden gespeicherte Sitzungen ungültig und eine neue Sitzung beginnt.
• Am besten geeignet für einen persönlichen Gateway-Host, nicht für gemeinsam genutzte Multi-User-Abrechnungsumgebungen.

​

Hinweise

• Die öffentlichen Claude-Code-Dokumente von Anthropic dokumentieren weiterhin die direkte CLI-Nutzung wie claude -p. Wir glauben, dass lokaler, benutzerverwalteter Fallback wahrscheinlich erlaubt ist, aber der separate Hinweis von Anthropic an OpenClaw-Nutzer besagt, dass der OpenClaw Claude-Login-Pfad eine Nutzung als Harness eines Drittanbieters ist und Extra Usage erfordert (nutzungsbasiert, getrennt vom Abonnement abgerechnet). Für den produktiven Einsatz empfehlen wir stattdessen Anthropic-API-Schlüssel.
• Das Anthropic-Setup-Token ist in OpenClaw wieder als veralteter/manueller Pfad verfügbar. Der OpenClaw-spezifische Hinweis von Anthropic zur Abrechnung gilt weiterhin, daher sollten Sie diesen Pfad mit der Erwartung nutzen, dass Anthropic dafür Extra Usage verlangt.
• Details zur Authentifizierung + Regeln zur Wiederverwendung finden Sie unter /concepts/oauth.

​

Fehlerbehebung

• Veraltete Anthropic-Token-Authentifizierung kann ablaufen oder widerrufen werden.
• Für neue Setups sollten Sie zu einem Anthropic-API-Schlüssel oder dem lokalen Claude-CLI-Pfad auf dem Gateway-Host migrieren.

• Authentifizierung ist pro Agent. Neue Agenten übernehmen die Schlüssel des Hauptagenten nicht.
• Führen Sie das Onboarding für diesen Agenten erneut aus oder konfigurieren Sie einen API-Schlüssel auf dem Gateway- Host und prüfen Sie dann 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 oder Claude CLI für diesen Profilpfad.

• Prüfen Sie openclaw models status --json auf auth.unusableProfiles.
• Anthropic-Cooldowns für Ratenlimits können modellspezifisch sein, sodass ein benachbartes Anthropic- Modell möglicherweise weiterhin verwendbar ist, auch wenn das aktuelle gerade im Cooldown ist.
• Fügen Sie ein weiteres Anthropic-Profil hinzu oder warten Sie das Ende des Cooldowns ab.