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 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-provideropenclaw gateway restartErste 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-keySie 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-gatewayNicht 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>", }, }, }, },}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.
