OpenClawDocs
Na tej stronie

Na tej stronie

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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)

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:

bash
openclaw plugins install @openclaw/cloudflare-ai-gateway-provideropenclaw gateway restart

Pierwsze kroki

  • Ustaw klucz API dostawcy i dane Gateway

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

    bash
    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:

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

  • Sprawdź, czy model jest dostępny

    bash
    openclaw models list --provider cloudflare-ai-gateway

    • Przykład nieinteraktywny

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

    bash
    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.

    json5
    {  models: {    providers: {      "cloudflare-ai-gateway": {        headers: {          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",        },      },    },  },}
    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.

    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.
    Was this useful?