Cloudflare AI-gateway

Cloudflare AI Gateway bevindt zich vóór de provider-API’s en voegt analyses, caching en beheermogelijkheden toe. Voor Anthropic gebruikt OpenClaw de Anthropic Messages API via je Gateway-eindpunt.

Eigenschap	Waarde
Provider	`cloudflare-ai-gateway`
Plugin	officieel extern pakket (`@openclaw/cloudflare-ai-gateway-provider`)
Basis-URL	`https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic`
Standaardmodel	`cloudflare-ai-gateway/claude-sonnet-4-6`
API-sleutel	`CLOUDFLARE_AI_GATEWAY_API_KEY` (je provider-API-sleutel voor aanvragen via de Gateway)

Gebruik voor Anthropic-modellen die via Cloudflare AI Gateway worden gerouteerd je Anthropic API-sleutel als providersleutel.

Wanneer thinking is ingeschakeld voor Anthropic Messages-modellen, verwijdert OpenClaw afsluitende assistant-prefillbeurten voordat de payload via Cloudflare AI Gateway wordt verzonden. Anthropic weigert het vooraf invullen van antwoorden bij extended thinking, terwijl gewone prefill zonder thinking beschikbaar blijft.

Plugin installeren

Installeer de officiële Plugin en start daarna de Gateway opnieuw:

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

Aan de slag

De provider-API-sleutel en Gateway-gegevens instellen

Voer de onboarding uit en kies de authenticatieoptie voor Cloudflare AI Gateway:

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

Je wordt gevraagd om je account-ID, gateway-ID en API-sleutel.

Een standaardmodel instellen

Voeg het model toe aan je OpenClaw-configuratie:

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

Controleren of het model beschikbaar is

openclaw models list --provider cloudflare-ai-gateway

Niet-interactief voorbeeld

Geef voor gescripte configuraties of CI-configuraties alle waarden op via de opdrachtregel:

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"

Geavanceerde configuratie

Geverifieerde gateways

Als je Gateway-authenticatie in Cloudflare hebt ingeschakeld, voeg je de header cf-aig-authorization toe. Dit komt naast je provider-API-sleutel.

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

De header cf-aig-authorization verifieert je bij de Cloudflare Gateway zelf, terwijl de provider-API-sleutel (bijvoorbeeld je Anthropic-sleutel) je bij de upstreamprovider verifieert.

Opmerking over de omgeving

Als de Gateway als daemon (launchd/systemd) wordt uitgevoerd, moet CLOUDFLARE_AI_GATEWAY_API_KEY beschikbaar zijn voor dat proces.

Een sleutel die alleen in een interactieve shell is geëxporteerd, helpt een launchd/systemd-daemon niet, tenzij die omgeving daar ook wordt geïmporteerd. Stel de sleutel in via ~/.openclaw/.env of env.shellEnv, zodat het gatewayproces deze kan lezen.

Overview

Concepts and configuration

Providers

Cloudflare AI-gateway

Plugin installeren

Aan de slag

Niet-interactief voorbeeld

Geavanceerde configuratie

Gerelateerd

Modelselectie

Problemen oplossen

​Plugin installeren

​Aan de slag

​Niet-interactief voorbeeld

​Geavanceerde configuratie

​Gerelateerd

Modelselectie

Problemen oplossen

Plugin installeren

Aan de slag

Niet-interactief voorbeeld

Geavanceerde configuratie

Gerelateerd