Providers

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)

Wenn das Denken 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 Denken ab, während gewöhnliches Vorbefüllen ohne Denken weiterhin verfügbar ist.

Plugin installieren

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

bash
openclaw plugins install @openclaw/cloudflare-ai-gateway-provideropenclaw 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:

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

    Sie werden dabei nach Ihrer Konto-ID, Gateway-ID und Ihrem API-Schlüssel gefragt.

  • Ein Standardmodell festlegen

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

    json5
    {  agents: {    defaults: {      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },    },  },}
  • Verfügbarkeit des Modells überprüfen

    bash
    openclaw models list --provider cloudflare-ai-gateway
  • Nicht interaktives Beispiel

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

    bash
    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 wird zusätzlich zu Ihrem Provider-API-Schlüssel benötigt.

    json5
    {  models: {    providers: {      "cloudflare-ai-gateway": {        headers: {          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",        },      },    },  },}
    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.

    Verwandte Themen

    Was this useful?
    On this page

    On this page