Zum Hauptinhalt springen
Cloudflare AI Gateway sitzt vor Provider-APIs und ermöglicht Ihnen, Analysen, Caching und Steuerungen hinzuzufügen. Für Anthropic verwendet OpenClaw die Anthropic Messages API über Ihren Gateway-Endpunkt.
EigenschaftWert
Providercloudflare-ai-gateway
Basis-URLhttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Standardmodellcloudflare-ai-gateway/claude-sonnet-4-6
API-SchlüsselCLOUDFLARE_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 geroutet werden, Ihren Anthropic-API-Schlüssel als Provider-Schlüssel.
Wenn Thinking für Anthropic-Messages-Modelle aktiviert ist, entfernt OpenClaw nachgestellte Assistant-Prefill-Turns, bevor die Nutzdaten über Cloudflare AI Gateway gesendet werden. Anthropic lehnt Response-Prefilling mit erweitertem Thinking ab, während gewöhnliches Prefill ohne Thinking weiterhin verfügbar bleibt.

​
Plugin installieren

Installieren Sie das offizielle Plugin und starten Sie anschließend Gateway neu: 
openclaw plugins install @openclaw/cloudflare-ai-gateway-provider
openclaw gateway restart

​
Erste Schritte

1

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
Dadurch werden Sie nach Ihrer Konto-ID, Gateway-ID und Ihrem API-Schlüssel gefragt.
2

Ein Standardmodell festlegen

Fügen Sie das Modell Ihrer OpenClaw-Konfiguration hinzu:
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}
3

Prüfen, ob das Modell verfügbar ist

openclaw models list --provider cloudflare-ai-gateway

​
Nicht interaktives Beispiel

Übergeben Sie für Skript- oder CI-Setups 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

Wenn Sie Gateway-Authentifizierung in Cloudflare aktiviert haben, fügen Sie den Header cf-aig-authorization hinzu. Dies gilt zusätzlich zu Ihrem Provider-API-Schlüssel.
{
  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 (zum Beispiel Ihr Anthropic-Schlüssel) beim Upstream-Provider authentifiziert.
Wenn das Gateway als Daemon ausgeführt wird (launchd/systemd), stellen Sie sicher, dass CLOUDFLARE_AI_GATEWAY_API_KEY für diesen Prozess verfügbar ist.
Ein Schlüssel, der nur in einer interaktiven Shell exportiert wurde, hilft einem launchd/systemd-Daemon nicht, sofern diese Umgebung nicht ebenfalls dort importiert wird. Legen Sie den Schlüssel in ~/.openclaw/.env oder über env.shellEnv fest, um sicherzustellen, dass der Gateway-Prozess ihn lesen kann.

​
Verwandte Themen

Modellauswahl

Auswahl von Providern, Modellreferenzen und Failover-Verhalten.

Fehlerbehebung

Allgemeine Fehlerbehebung und FAQ.