Providers

Anthropic

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

Erste Schritte

API key

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

Get your API key

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

Run onboarding

openclaw onboard
# choose: Anthropic API key

Oder übergeben Sie den Schlüssel direkt:

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

Verify the model is available

openclaw models list --provider anthropic

Konfigurationsbeispiel

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

Claude CLI

Am besten für: die Wiederverwendung einer vorhandenen Claude-CLI-Anmeldung ohne separaten API-Schlüssel.

Ensure Claude CLI is installed and logged in

Prüfen Sie dies mit:

claude --version

Run onboarding

openclaw onboard
# choose: Claude CLI

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

Verify the model is available

openclaw models list --provider anthropic

Konfigurationsbeispiel

Bevorzugen Sie die kanonische Anthropic-Modellreferenz plus eine CLI-Laufzeitüberschreibung:

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-7" },
      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 agentRuntime.id ablegen.

Thinking-Standards (Claude 4.6)

Claude-4.6-Modelle verwenden in OpenClaw standardmäßig adaptive Thinking, wenn keine explizite Thinking-Stufe festgelegt ist.

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

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

Prompt-Caching

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

Wert	Cache-Dauer	Beschreibung
`"short"` (Standard)	5 Minuten	Wird 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" },
        },
      },
    },
  },
}

Per-agent cache overrides

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

Zusammenführungsreihenfolge der Konfiguration:

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

So kann ein Agent einen langlebigen Cache behalten, während ein anderer Agent mit demselben Modell das Caching für sprunghaften Traffic mit geringer Wiederverwendung deaktiviert.

Bedrock Claude notes

Anthropic-Claude-Modelle auf Bedrock (amazon-bedrock/*anthropic.claude*) akzeptieren bei entsprechender Konfiguration cacheRetention als Durchleitung.
Nicht-Anthropic-Bedrock-Modelle werden zur Laufzeit auf cacheRetention: "none" gezwungen.
Intelligente Standards für API-Schlüssel setzen außerdem cacheRetention: "short" für Claude-on-Bedrock-Referenzen, wenn kein expliziter Wert festgelegt ist.

Erweiterte Konfiguration

Fast mode

OpenClaws gemeinsamer /fast-Schalter unterstützt direkten Anthropic-Traffic (API-Schlüssel und OAuth zu api.anthropic.com).

Befehl	Wird zugeordnet zu
`/fast on`	`service_tier: "auto"`
`/fast off`	`service_tier: "standard_only"`

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

Media understanding (image and PDF)

Das gebündelte Anthropic-Plugin registriert Bild- und PDF-Verständnis. OpenClaw löst Medienfunktionen automatisch aus der konfigurierten Anthropic-Authentifizierung auf; zusätzliche Konfiguration ist nicht erforderlich.

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

Wenn ein Bild oder PDF an eine Unterhaltung angehängt wird, leitet OpenClaw es automatisch über den Anthropic-Provider für Medienverständnis weiter.

1M context window (beta)

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 außerdem für das Claude-CLI-Backend (claude-cli/*) bei geeigneten Opus- und Sonnet-Modellen und erweitert das Laufzeit-Kontextfenster für diese CLI-Sitzungen so, dass es dem Direkt-API-Verhalten entspricht.

Claude Opus 4.7 1M context

anthropic/claude-opus-4.7 und seine claude-cli-Variante haben standardmäßig ein 1M-Kontextfenster; params.context1m: true ist nicht erforderlich.

Fehlerbehebung

401 errors / token suddenly invalid

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

No API key found for provider "anthropic"

Anthropic-Authentifizierung gilt 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.

No credentials found for profile "anthropic:default"

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.

No available auth profile (all in cooldown)

Prüfen Sie openclaw models status --json auf auth.unusableProfiles. Anthropic-Rate-Limit-Cooldowns können modellspezifisch sein, sodass ein verwandtes Anthropic-Modell möglicherweise weiterhin verwendbar ist. Fügen Sie ein weiteres Anthropic-Profil hinzu oder warten Sie auf den Ablauf des Cooldowns.

Anthropic

Erste Schritte

API key

Get your API key

Run onboarding

Verify the model is available

Konfigurationsbeispiel

Claude CLI

Ensure Claude CLI is installed and logged in

Run onboarding

Verify the model is available

Konfigurationsbeispiel

Thinking-Standards (Claude 4.6)

Prompt-Caching

Erweiterte Konfiguration

Fehlerbehebung

Verwandte Themen

Ask OpenClaw

# Erste Schritte

API key

Get your API key

Run onboarding

Verify the model is available

# Konfigurationsbeispiel

Claude CLI

Ensure Claude CLI is installed and logged in

Run onboarding

Verify the model is available

# Konfigurationsbeispiel

# Thinking-Standards (Claude 4.6)

# Prompt-Caching

# Erweiterte Konfiguration

# Fehlerbehebung

# Verwandte Themen

Erste Schritte

Konfigurationsbeispiel

Konfigurationsbeispiel

Thinking-Standards (Claude 4.6)

Prompt-Caching

Erweiterte Konfiguration

Fehlerbehebung

Verwandte Themen