Cloudflare AI Gateway mit OpenClaw einrichten

Wenn du mit Provider-APIs arbeitest, merkst du schnell: Ohne Logging und Caching wird es unübersichtlich. Du willst sehen, welche Daten fließen, und unnötige Kosten durch doppelte Requests vermeiden. Ein Gateway zwischen deiner App und der API hilft dir, die Kontrolle zu behalten.

Cloudflare AI Gateway schaltet sich vor die Provider-APIs. Für Anthropic nutzt OpenClaw die Anthropic Messages API über deinen Gateway-Endpoint.

Voraussetzungen

• Cloudflare Account ID
• Cloudflare Gateway ID
• Anthropic API Key
• Cloudflare AI Gateway API Key

Schnellstart

In 5 Minuten ist dein Gateway einsatzbereit. Folge diesen Schritten:

1. Konfiguriere den Provider und die Gateway-Details über das CLI:

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

2. Lege ein Default-Modell in deiner Konfiguration fest:

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

Non-interactive Setup

Falls du das Setup automatisieren möchst, kannst du alle Parameter direkt übergeben:

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"

Fehlerbehebung

Authenticated Gateways

Falls du die Gateway-Authentifizierung in Cloudflare aktiviert hast, musst du den cf-aig-authorization Header zusätzlich zu deinem Provider API Key hinzufügen:

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

Gateway als Daemon

Wenn das Gateway als Daemon läuft (z. B. via launchd oder systemd), stelle sicher, dass die Umgebungsvariable CLOUDFLARE_AI_GATEWAY_API_KEY für diesen Prozess verfügbar ist. Du kannst sie beispielsweise in ~/.openclaw/.env oder über env.shellEnv hinterlegen.

Brauchst du Hilfe bei der Einrichtung? Nutze den AI Setup Assistant.

Nächste Schritte

• Provider Configuration Overview
• Managing API Keys