Cloudflare-AI-Gateway

Cloudflare AI Gateway wird den Provider-APIs vorgeschaltet und ergänzt Analysen, Caching und Steuerungsmöglichkeiten. Für Anthropic verwendet OpenClaw die Anthropic Messages API über Ihren Gateway-Endpunkt.

Eigenschaft	Wert
Provider	`cloudflare-ai-gateway`
Plugin	offizielles externes Paket (`@openclaw/cloudflare-ai-gateway-provider`)
Basis-URL	`https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic`
Standardmodell	`cloudflare-ai-gateway/claude-sonnet-4-6`
API-Schlüssel	`CLOUDFLARE_AI_GATEWAY_API_KEY` (Ihr Provider-API-Schlüssel für Anfragen über das Gateway)

Verwenden Sie für Anthropic-Modelle, die über Cloudflare AI Gateway weitergeleitet werden, Ihren Anthropic-API-Schlüssel als Provider-Schlüssel.

Wenn Thinking für Anthropic-Messages-Modelle aktiviert ist, entfernt OpenClaw abschließende Assistant-Prefill-Turns, bevor die Nutzlast über Cloudflare AI Gateway gesendet wird. Anthropic lehnt das Vorbefüllen von Antworten bei erweitertem Thinking ab, während gewöhnliches Prefill ohne Thinking weiterhin verfügbar ist.

Plugin installieren

Installieren Sie das offizielle Plugin und starten Sie anschließend das Gateway neu:

openclaw plugins install @openclaw/cloudflare-ai-gateway-provider
openclaw gateway restart

Erste Schritte

Provider-API-Schlüssel und Gateway-Details festlegen

Führen Sie das Onboarding aus und wählen Sie die Authentifizierungsoption für Cloudflare AI Gateway:

openclaw onboard --auth-choice cloudflare-ai-gateway-api-key

Sie werden zur Eingabe Ihrer Konto-ID, Gateway-ID und Ihres API-Schlüssels aufgefordert.

Standardmodell festlegen

Fügen Sie das Modell Ihrer OpenClaw-Konfiguration hinzu:

{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}

Verfügbarkeit des Modells überprüfen

openclaw models list --provider cloudflare-ai-gateway

Nicht interaktives Beispiel

Übergeben Sie für skriptgesteuerte oder CI-Einrichtungen alle Werte über die Befehlszeile:

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice cloudflare-ai-gateway-api-key \
  --cloudflare-ai-gateway-account-id "your-account-id" \
  --cloudflare-ai-gateway-gateway-id "your-gateway-id" \
  --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY"

Erweiterte Konfiguration

Authentifizierte Gateways

Wenn Sie die Gateway-Authentifizierung in Cloudflare aktiviert haben, fügen Sie den Header cf-aig-authorization hinzu. Dieser ist zusätzlich zu Ihrem Provider-API-Schlüssel erforderlich.

{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}

Der Header cf-aig-authorization authentifiziert beim Cloudflare Gateway selbst, während der Provider-API-Schlüssel (beispielsweise Ihr Anthropic-Schlüssel) beim vorgelagerten Provider authentifiziert.

Hinweis zur Umgebung

Wenn das Gateway als Daemon (launchd/systemd) ausgeführt wird, stellen Sie sicher, dass CLOUDFLARE_AI_GATEWAY_API_KEY für diesen Prozess verfügbar ist.

Ein ausschließlich in einer interaktiven Shell exportierter Schlüssel steht einem launchd-/systemd-Daemon nur zur Verfügung, wenn die betreffende Umgebung auch dort importiert wird. Legen Sie den Schlüssel in ~/.openclaw/.env oder über env.shellEnv fest, damit der Gateway-Prozess darauf zugreifen kann.

Modellauswahl

Auswahl von Providern und Modellreferenzen sowie Konfiguration des Failover-Verhaltens.

Fehlerbehebung

Allgemeine Fehlerbehebung und häufig gestellte Fragen.

Overview

Concepts and configuration

Providers

Cloudflare-AI-Gateway

Plugin installieren

Erste Schritte

Nicht interaktives Beispiel

Erweiterte Konfiguration

Verwandte Themen

Modellauswahl

Fehlerbehebung

​Plugin installieren

​Erste Schritte

​Nicht interaktives Beispiel

​Erweiterte Konfiguration

​Verwandte Themen

Modellauswahl

Fehlerbehebung

Plugin installieren

Erste Schritte

Nicht interaktives Beispiel

Erweiterte Konfiguration

Verwandte Themen