Naar hoofdinhoud gaan

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 staat voor provider-API’s en laat je analytics, caching en besturingselementen toevoegen. Voor Anthropic gebruikt OpenClaw de Anthropic Messages API via je Gateway-eindpunt.
EigenschapWaarde
Providercloudflare-ai-gateway
Basis-URLhttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Standaardmodelcloudflare-ai-gateway/claude-sonnet-4-6
API-sleutelCLOUDFLARE_AI_GATEWAY_API_KEY (je provider-API-sleutel voor aanvragen via de Gateway)
Gebruik voor Anthropic-modellen die via Cloudflare AI Gateway worden gerouteerd je Anthropic API-sleutel als provider-sleutel.
Wanneer denken is ingeschakeld voor Anthropic Messages-modellen, verwijdert OpenClaw afsluitende assistant-prefill-beurten voordat de payload via Cloudflare AI Gateway wordt verzonden. Anthropic weigert antwoord-prefilling met uitgebreid denken, terwijl gewone prefill zonder denken beschikbaar blijft.

Aan de slag

1

Stel de provider-API-sleutel en Gateway-gegevens in

Voer onboarding uit en kies de authenticatieoptie voor Cloudflare AI Gateway:
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
Dit vraagt om je account-ID, gateway-ID en API-sleutel.
2

Stel een standaardmodel in

Voeg het model toe aan je OpenClaw-configuratie:
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}
3

Controleer of het model beschikbaar is

openclaw models list --provider cloudflare-ai-gateway

Niet-interactief voorbeeld

Geef voor gescripte of CI-configuraties alle waarden door via de opdrachtregel:
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"

Geavanceerde configuratie

Als je Gateway-authenticatie in Cloudflare hebt ingeschakeld, voeg dan de header cf-aig-authorization toe. Dit komt naast je provider-API-sleutel.
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}
De header cf-aig-authorization authenticeert bij de Cloudflare Gateway zelf, terwijl de provider-API-sleutel (bijvoorbeeld je Anthropic-sleutel) authenticeert bij de upstream-provider.
Als de Gateway als daemon draait (launchd/systemd), zorg er dan voor dat CLOUDFLARE_AI_GATEWAY_API_KEY beschikbaar is voor dat proces.
Een sleutel die alleen in ~/.profile staat, helpt een launchd/systemd-daemon niet, tenzij die omgeving daar ook wordt geïmporteerd. Stel de sleutel in ~/.openclaw/.env in of via env.shellEnv om te zorgen dat het gatewayproces deze kan lezen.

Gerelateerd

Modelselectie

Providers, modelreferenties en failover-gedrag kiezen.

Probleemoplossing

Algemene probleemoplossing en veelgestelde vragen.