الانتقال إلى المحتوى الرئيسي

​
Cloudflare AI Gateway

تقع 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-5
مفتاح APICLOUDFLARE_AI_GATEWAY_API_KEY (مفتاح API الخاص بالمزوّد لطلبات المرور عبر Gateway)
بالنسبة إلى نماذج Anthropic التي يتم توجيهها عبر Cloudflare AI Gateway، استخدم مفتاح Anthropic API الخاص بك كمفتاح للمزوّد.

​
البدء

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-5" },
    },
  },
}
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"

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

إذا قمت بتمكين مصادقة 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 الخاص بك) بالمصادقة مع المزوّد upstream.
إذا كان Gateway يعمل كخدمة daemon (launchd/systemd)، فتأكد من أن CLOUDFLARE_AI_GATEWAY_API_KEY متاح لتلك العملية.
لن يفيد وجود المفتاح فقط في ~/.profile خدمة daemon تعمل عبر launchd/systemd ما لم يتم أيضًا استيراد تلك البيئة هناك. عيّن المفتاح في ~/.openclaw/.env أو عبر env.shellEnv لضمان قدرة عملية gateway على قراءته.

​
ذو صلة

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

اختيار المزوّدين ومراجع النماذج وسلوك التبديل الاحتياطي.

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

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