Gateway AI Cloudflare

Cloudflare AI Gateway działa przed interfejsami API dostawców i dodaje analitykę, buforowanie oraz mechanizmy kontroli. W przypadku Anthropic OpenClaw korzysta z interfejsu Anthropic Messages API za pośrednictwem punktu końcowego Gateway.

Właściwość	Wartość
Dostawca	`cloudflare-ai-gateway`
Plugin	oficjalny pakiet zewnętrzny (`@openclaw/cloudflare-ai-gateway-provider`)
Bazowy adres URL	`https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic`
Model domyślny	`cloudflare-ai-gateway/claude-sonnet-4-6`
Klucz API	`CLOUDFLARE_AI_GATEWAY_API_KEY` (klucz API dostawcy używany do żądań przesyłanych przez Gateway)

W przypadku modeli Anthropic kierowanych przez Cloudflare AI Gateway jako klucza dostawcy użyj swojego klucza API Anthropic.

Gdy myślenie jest włączone dla modeli Anthropic Messages, OpenClaw usuwa końcowe tury wstępnie wypełnione przez asystenta przed wysłaniem ładunku przez Cloudflare AI Gateway. Anthropic odrzuca wstępne wypełnianie odpowiedzi przy rozszerzonym myśleniu, natomiast zwykłe wstępne wypełnianie bez myślenia pozostaje dostępne.

Instalowanie pluginu

Zainstaluj oficjalny plugin, a następnie uruchom ponownie Gateway:

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

Pierwsze kroki

Ustaw klucz API dostawcy i dane Gateway

Uruchom konfigurację początkową i wybierz opcję uwierzytelniania Cloudflare AI Gateway:

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

Zostanie wyświetlona prośba o identyfikator konta, identyfikator Gateway i klucz API.

Ustaw model domyślny

Dodaj model do konfiguracji OpenClaw:

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

Sprawdź, czy model jest dostępny

openclaw models list --provider cloudflare-ai-gateway

Przykład nieinteraktywny

W przypadku konfiguracji skryptowych lub CI przekaż wszystkie wartości w wierszu poleceń:

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"

Konfiguracja zaawansowana

Uwierzytelniane Gateway

Jeśli włączono uwierzytelnianie Gateway w Cloudflare, dodaj nagłówek cf-aig-authorization. Jest on wymagany oprócz klucza API dostawcy.

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

Nagłówek cf-aig-authorization służy do uwierzytelniania w samym Cloudflare Gateway, natomiast klucz API dostawcy (na przykład klucz Anthropic) służy do uwierzytelniania u dostawcy nadrzędnego.

Uwaga dotycząca środowiska

Jeśli Gateway działa jako demon (launchd/systemd), upewnij się, że zmienna CLOUDFLARE_AI_GATEWAY_API_KEY jest dostępna dla tego procesu.

Klucz wyeksportowany wyłącznie w interaktywnej powłoce nie będzie dostępny dla demona launchd/systemd, chyba że to środowisko również zostanie do niego zaimportowane. Ustaw klucz w pliku ~/.openclaw/.env lub za pomocą env.shellEnv, aby proces Gateway mógł go odczytać.

Powiązane materiały

Wybór modelu

Wybieranie dostawców, odwołań do modeli i zachowania mechanizmu przełączania awaryjnego.

Rozwiązywanie problemów

Ogólne wskazówki dotyczące rozwiązywania problemów i często zadawane pytania.

Overview

Concepts and configuration

Providers

Gateway AI Cloudflare

Instalowanie pluginu

Pierwsze kroki

Przykład nieinteraktywny

Konfiguracja zaawansowana

Powiązane materiały

Wybór modelu

Rozwiązywanie problemów

​Instalowanie pluginu

​Pierwsze kroki

​Przykład nieinteraktywny

​Konfiguracja zaawansowana

​Powiązane materiały

Wybór modelu

Rozwiązywanie problemów

Instalowanie pluginu

Pierwsze kroki

Przykład nieinteraktywny

Konfiguracja zaawansowana

Powiązane materiały