بوابة Cloudflare للذكاء الاصطناعي

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

الخاصية	القيمة
موفّر الخدمة	`cloudflare-ai-gateway`
Plugin	حزمة خارجية رسمية (`@openclaw/cloudflare-ai-gateway-provider`)
عنوان 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 الملء المسبق للاستجابة عند استخدام التفكير الموسّع، بينما يظل الملء المسبق العادي من دون تفكير متاحًا.

تثبيت Plugin

ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway:

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

البدء

تعيين مفتاح API لموفّر الخدمة وتفاصيل Gateway

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

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

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

تعيين نموذج افتراضي

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

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

التحقق من توفر النموذج

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 المصادَق عليها

إذا مكّنت مصادقة 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 لتلك العملية.

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

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

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

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

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

Overview

Concepts and configuration

Providers

بوابة Cloudflare للذكاء الاصطناعي

تثبيت Plugin

البدء

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

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

مواضيع ذات صلة

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

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

​تثبيت Plugin

​البدء

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

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

​مواضيع ذات صلة

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

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

تثبيت Plugin

البدء

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

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

مواضيع ذات صلة