Gateway الذكاء الاصطناعي من Cloudflare

يقع Cloudflare AI Gateway أمام واجهات API للمزوّدين ويتيح لك إضافة التحليلات والتخزين المؤقت وعناصر التحكم. بالنسبة إلى Anthropic، يستخدم OpenClaw واجهة Anthropic Messages API عبر نقطة نهاية Gateway الخاصة بك.

الخاصية	القيمة
المزوّد	cloudflare-ai-gateway
عنوان URL الأساسي	https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
النموذج الافتراضي	cloudflare-ai-gateway/claude-sonnet-4-6
مفتاح API	CLOUDFLARE_AI_GATEWAY_API_KEY (مفتاح API الخاص بالمزوّد لديك للطلبات عبر Gateway)

بالنسبة إلى نماذج Anthropic الموجّهة عبر Cloudflare AI Gateway، استخدم مفتاح Anthropic API الخاص بك كمفتاح المزوّد.

عند تمكين التفكير لنماذج Anthropic Messages، يزيل OpenClaw أدوار الملء المسبق اللاحقة الخاصة بالمساعد قبل إرسال الحمولة عبر Cloudflare AI Gateway. ترفض Anthropic الملء المسبق للاستجابة مع التفكير الموسّع، بينما يظل الملء المسبق العادي من دون تفكير متاحًا.

​

البدء

1. عيّن مفتاح API للمزوّد وتفاصيل Gateway

   شغّل الإعداد الأولي واختر خيار مصادقة Cloudflare AI Gateway:

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

   سيطلب ذلك معرّف الحساب ومعرّف Gateway ومفتاح API.

2. عيّن نموذجًا افتراضيًا

   أضف النموذج إلى إعدادات OpenClaw لديك:

   {
     agents: {
       defaults: {
         model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
       },
     },
   }
   
3. تحقق من أن النموذج متاح

   openclaw models list --provider cloudflare-ai-gateway
   

​

مثال غير تفاعلي

لإعدادات البرمجة النصية أو CI، مرّر كل القيم في سطر الأوامر:

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"

​

الإعدادات المتقدمة

Gateways مصادَق عليها

إذا فعّلت مصادقة Gateway في Cloudflare، فأضف ترويسة cf-aig-authorization. هذا إضافةً إلى مفتاح API الخاص بالمزوّد لديك.

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

تصادق ترويسة cf-aig-authorization مع Cloudflare Gateway نفسه، بينما يصادق مفتاح API الخاص بالمزوّد (على سبيل المثال، مفتاح Anthropic لديك) مع المزوّد المنبعي.

ملاحظة عن البيئة

إذا كان Gateway يعمل كخدمة خفية (launchd/systemd)، فتأكد من أن CLOUDFLARE_AI_GATEWAY_API_KEY متاح لتلك العملية.

وجود المفتاح في ~/.profile فقط لن يفيد خدمة launchd/systemd خفية ما لم تُستورد تلك البيئة هناك أيضًا. عيّن المفتاح في ~/.openclaw/.env أو عبر env.shellEnv لضمان أن عملية Gateway يمكنها قراءته.

​

ذات صلة

اختيار النموذج

اختيار المزوّدين ومراجع النماذج وسلوك تجاوز الفشل.

استكشاف الأخطاء وإصلاحها

استكشاف الأخطاء وإصلاحها العام والأسئلة الشائعة.