Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Cloudflare AI Gateway znajduje się przed interfejsami API dostawców i pozwala dodać analitykę, buforowanie oraz mechanizmy 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
Model domyślnycloudflare-ai-gateway/claude-sonnet-4-6
Klucz APICLOUDFLARE_AI_GATEWAY_API_KEY (klucz API dostawcy dla żądań przez Gateway)
W przypadku 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łniania 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.

​
Pierwsze kroki

1

Set the provider API key and Gateway details

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

Set a default model

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

Verify the model is available

openclaw models list --provider cloudflare-ai-gateway

​
Przykład nieinteraktywny

W konfiguracjach 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 dodatkowe względem 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 dostawcy nadrzędnego.
Jeśli Gateway działa jako demon (launchd/systemd), upewnij się, że CLOUDFLARE_AI_GATEWAY_API_KEY jest dostępny dla tego procesu.
Klucz znajdujący się tylko w ~/.profile 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ć procesowi gateway możliwość jego odczytu.

​
Powiązane

Model selection

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

Troubleshooting

Ogólne rozwiązywanie problemów i FAQ.