Ana içeriğe atla

Cloudflare AI Gateway

Cloudflare AI Gateway, sağlayıcı API’lerinin önünde yer alır ve analiz, önbellekleme ve denetimler eklemenize olanak tanır. Anthropic için OpenClaw, Gateway uç noktanız üzerinden Anthropic Messages API’yi kullanır.
ÖzellikDeğer
Sağlayıcıcloudflare-ai-gateway
Temel URLhttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Varsayılan modelcloudflare-ai-gateway/claude-sonnet-4-5
API keyCLOUDFLARE_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 modelleri için sağlayıcı anahtarı olarak Anthropic API key kullanın.

Başlangıç

1

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

Başlangıç kurulumunu çalıştırın ve Cloudflare AI Gateway kimlik doğrulama seçeneğini seçin:
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
Bu işlem hesap kimliğinizi, gateway kimliğinizi ve API anahtarınızı ister.
2

Varsayılan bir model ayarlayın

Modeli OpenClaw yapılandırmanıza ekleyin:
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-5" },
    },
  },
}
3

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

openclaw models list --provider cloudflare-ai-gateway

Etkileşimsiz örnek

Betik veya CI kurulumları için 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

Cloudflare’da Gateway kimlik doğrulamasını etkinleştirdiyseniz cf-aig-authorization üst bilgisini ekleyin. Bu, sağlayıcı API anahtarınıza ek olarak gerekir.
{
  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ğrular; sağlayıcı API anahtarı ise (örneğin Anthropic anahtarınız) yukarı akış sağlayıcıda kimlik doğrular.
Gateway bir daemon olarak çalışıyorsa (launchd/systemd), CLOUDFLARE_AI_GATEWAY_API_KEY değerinin bu süreç tarafından kullanılabildiğinden emin olun.
Yalnızca ~/.profile içinde bulunan bir anahtar, bu ortam oraya da aktarılmadığı sürece bir launchd/systemd daemon’una yardımcı olmaz. Gateway sürecinin bunu 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.