Przejdź do głównej treści
Cloudflare AI Gateway znajduje się przed API dostawców i umożliwia dodanie analityki, buforowania oraz kontroli. W przypadku Anthropic OpenClaw używa Anthropic Messages API przez punkt końcowy Gateway.
WłaściwośćWartość
Dostawcacloudflare-ai-gateway
Bazowy URLhttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Domyślny modelcloudflare-ai-gateway/claude-sonnet-4-6
Klucz APICLOUDFLARE_AI_GATEWAY_API_KEY (klucz API dostawcy dla żądań przez Gateway)
Dla modeli Anthropic kierowanych przez Cloudflare AI Gateway użyj swojego klucza API Anthropic jako klucza dostawcy.
Gdy myślenie jest włączone dla modeli Anthropic Messages, OpenClaw usuwa końcowe tury wstępnego wypełnienia asystenta przed wysłaniem ładunku przez Cloudflare AI Gateway. Anthropic odrzuca wstępne wypełnianie odpowiedzi z rozszerzonym myśleniem, natomiast zwykłe wstępne wypełnianie bez myślenia pozostaje dostępne.

​
Zainstaluj plugin

Zainstaluj oficjalny plugin, a następnie uruchom ponownie Gateway: 
openclaw plugins install @openclaw/cloudflare-ai-gateway-provider
openclaw gateway restart

​
Pierwsze kroki

1

Ustaw klucz API dostawcy i szczegóły Gateway

Uruchom wdrażanie i wybierz opcję uwierzytelniania Cloudflare AI Gateway:
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
Zostaniesz poproszony o identyfikator konta, identyfikator gateway oraz klucz API.
2

Ustaw domyślny model

Dodaj model do konfiguracji OpenClaw:
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}
3

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

Jeśli włączono uwierzytelnianie Gateway w Cloudflare, dodaj nagłówek cf-aig-authorization. Jest to dodatek do klucza API dostawcy.
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}
Nagłówek cf-aig-authorization uwierzytelnia w samym Cloudflare Gateway, natomiast klucz API dostawcy (na przykład klucz Anthropic) uwierzytelnia u nadrzędnego dostawcy.
Jeśli Gateway działa jako demon (launchd/systemd), upewnij się, że CLOUDFLARE_AI_GATEWAY_API_KEY jest dostępny dla tego procesu.
Klucz wyeksportowany tylko w interaktywnej powłoce nie pomoże demonowi launchd/systemd, chyba że to środowisko również zostanie tam zaimportowane. Ustaw klucz w ~/.openclaw/.env lub przez env.shellEnv, aby zapewnić, że proces gateway będzie mógł go odczytać.

​
Powiązane

Wybór modelu

Wybieranie dostawców, referencji modeli i zachowania przełączania awaryjnego.

Rozwiązywanie problemów

Ogólne rozwiązywanie problemów i często zadawane pytania.