Cloudflare AI gateway'i

Cloudflare AI Gateway, sağlayıcı API’lerinin önünde yer alır ve analiz, önbelleğe alma ve denetimler ekler. Anthropic için OpenClaw, Gateway uç noktanız üzerinden Anthropic Messages API’sini kullanır.

Özellik	Değer
Sağlayıcı	`cloudflare-ai-gateway`
Plugin	resmi harici paket (`@openclaw/cloudflare-ai-gateway-provider`)
Temel URL	`https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic`
Varsayılan model	`cloudflare-ai-gateway/claude-sonnet-4-6`
API anahtarı	`CLOUDFLARE_AI_GATEWAY_API_KEY` (Gateway üzerinden yapılan istekler için sağlayıcı API anahtarınız)

Cloudflare AI Gateway üzerinden yönlendirilen Anthropic modellerinde sağlayıcı anahtarı olarak Anthropic API anahtarınızı kullanın.

Anthropic Messages modellerinde düşünme etkinleştirildiğinde OpenClaw, yükü Cloudflare AI Gateway üzerinden göndermeden önce sondaki asistan ön doldurma turlarını kaldırır. Anthropic, genişletilmiş düşünmeyle yanıt ön doldurmayı reddederken sıradan düşünmesiz ön doldurma kullanılabilir durumda kalır.

Plugin’i yükleme

Resmi Plugin’i yükleyin, ardından Gateway’i yeniden başlatın:

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

Başlarken

Sağlayıcı API anahtarını ve Gateway ayrıntılarını ayarlayın

İlk katılımı çalıştırın ve Cloudflare AI Gateway kimlik doğrulama seçeneğini belirleyin:

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

Bu işlem hesap kimliğinizi, gateway kimliğinizi ve API anahtarınızı girmenizi ister.

Varsayılan model ayarlayın

Modeli OpenClaw yapılandırmanıza ekleyin:

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

Modelin kullanılabilir olduğunu doğrulayın

openclaw models list --provider cloudflare-ai-gateway

Etkileşimsiz örnek

Betik tabanlı veya CI kurulumlarında tüm değerleri komut satırında iletin:

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"

Gelişmiş yapılandırma

Kimliği doğrulanmış gateway'ler

Cloudflare’de Gateway kimlik doğrulamasını etkinleştirdiyseniz cf-aig-authorization üst bilgisini ekleyin. Bu, sağlayıcı API anahtarınıza ek olarak gereklidir.

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

cf-aig-authorization üst bilgisi Cloudflare Gateway’in kendisinde kimlik doğrulaması yaparken sağlayıcı API anahtarı (örneğin Anthropic anahtarınız) üst akış sağlayıcısında kimlik doğrulaması yapar.

Ortam notu

Gateway bir daemon (launchd/systemd) olarak çalışıyorsa CLOUDFLARE_AI_GATEWAY_API_KEY değerinin bu işlem tarafından kullanılabildiğinden emin olun.

Yalnızca etkileşimli bir kabukta dışa aktarılan anahtar, söz konusu ortam oraya da aktarılmadığı sürece launchd/systemd daemon’una yardımcı olmaz. Gateway işleminin anahtarı okuyabilmesini sağlamak için anahtarı ~/.openclaw/.env içinde veya env.shellEnv aracılığıyla ayarlayın.

İlgili

Model seçimi

Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme.

Sorun giderme

Genel sorun giderme ve SSS.

Overview

Concepts and configuration

Providers

Cloudflare AI gateway'i

Plugin’i yükleme

Başlarken

Etkileşimsiz örnek

Gelişmiş yapılandırma

İlgili

Model seçimi

Sorun giderme

​Plugin’i yükleme

​Başlarken

​Etkileşimsiz örnek

​Gelişmiş yapılandırma

​İlgili

Model seçimi

Sorun giderme

Plugin’i yükleme

Başlarken

Etkileşimsiz örnek

Gelişmiş yapılandırma

İlgili