OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

SGLang

تتيح SGLang نماذج ذات أوزان مفتوحة عبر واجهة HTTP API متوافقة مع OpenAI. يتصل OpenClaw بـ SGLang باستخدام عائلة المزوّد openai-completions مع الاكتشاف التلقائي للنماذج المتاحة.

الخاصية القيمة
معرّف المزوّد sglang
Plugin مضمّن، enabledByDefault: true
متغير بيئة المصادقة SGLANG_API_KEY (أي قيمة غير فارغة إذا كان الخادم بلا مصادقة)
خيار الإعداد الأولي --auth-choice sglang
API متوافقة مع OpenAI ‏(openai-completions)
عنوان URL الأساسي الافتراضي http://127.0.0.1:30000/v1
العنصر النائب للنموذج الافتراضي sglang/Qwen/Qwen3-8B
استخدام البث التدفقي نعم (supportsStreamingUsage: true)
التسعير معلّم بوصفه خارجيًا مجانيًا (modelPricing.external: false)

يكتشف OpenClaw أيضًا النماذج المتاحة من SGLang تلقائيًا عند الاشتراك باستخدام SGLANG_API_KEY. استخدم sglang/* في agents.defaults.models لإبقاء الاكتشاف ديناميكيًا عند تهيئة عنوان URL أساسي مخصص لـ SGLang أيضًا. راجع اكتشاف النماذج (المزوّد الضمني) أدناه.

بدء الاستخدام

  • تشغيل SGLang

    شغّل SGLang مع خادم متوافق مع OpenAI. يجب أن يوفّر عنوان URL الأساسي نقاط نهاية /v1 (مثل /v1/models و/v1/chat/completions). تعمل SGLang عادةً على:

    • http://127.0.0.1:30000/v1

  • تعيين مفتاح API

    تصلح أي قيمة إذا لم تُهيّأ المصادقة على خادمك:

    bash
    export SGLANG_API_KEY="sglang-local"

  • تشغيل الإعداد الأولي أو تعيين نموذج مباشرةً

    bash
    openclaw onboard

    أو هيّئ النموذج يدويًا:

    json5
    {  agents: {    defaults: {      model: { primary: "sglang/your-model-id" },    },  },}

    • اكتشاف النماذج (المزوّد الضمني)

    عند تعيين SGLANG_API_KEY (أو وجود ملف تعريف للمصادقة) وعدم تعريف models.providers.sglang، يستعلم OpenClaw عن:

    • GET http://127.0.0.1:30000/v1/models

    ويحوّل المعرّفات المُعادة إلى إدخالات نماذج.

    التهيئة الصريحة (النماذج اليدوية)

    استخدم التهيئة الصريحة عندما:

    • تعمل SGLang على مضيف أو منفذ مختلف.
    • تريد تثبيت قيم contextWindow/maxTokens.
    • يتطلب خادمك مفتاح API حقيقيًا (أو تريد التحكم في الترويسات).
    json5
    {  models: {    providers: {      sglang: {        baseUrl: "http://127.0.0.1:30000/v1",        apiKey: "${SGLANG_API_KEY}",        api: "openai-completions",        models: [          {            id: "your-model-id",            name: "Local SGLang Model",            reasoning: false,            input: ["text"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 128000,            maxTokens: 8192,          },        ],      },    },  },}

    التهيئة المتقدمة

    السلوك على نمط الوكيل

    تُعامل SGLang كواجهة خلفية /v1 على نمط الوكيل ومتوافقة مع OpenAI، وليست نقطة نهاية أصلية لـ OpenAI.

    السلوك SGLang
    تشكيل الطلبات الخاص بـ OpenAI فقط غير مطبّق
    service_tier، وstore في Responses، وتلميحات ذاكرة التخزين المؤقت للموجّهات لا تُرسل
    تشكيل الحمولة المتوافق مع الاستدلال غير مطبّق
    ترويسات الإسناد المخفية (originator وversion وUser-Agent) لا تُحقن في عناوين URL الأساسية المخصصة لـ SGLang
    استكشاف الأخطاء وإصلاحها

    يتعذر الوصول إلى الخادم

    تحقّق من أن الخادم يعمل ويستجيب:

    bash
    curl http://127.0.0.1:30000/v1/models

    أخطاء المصادقة

    إذا فشلت الطلبات بسبب أخطاء المصادقة، فعيّن قيمة حقيقية لـ SGLANG_API_KEY تطابق تهيئة خادمك، أو هيّئ المزوّد صراحةً ضمن models.providers.sglang.

    ذو صلة

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

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

    مخطط التهيئة الكامل، بما في ذلك إدخالات المزوّدين.
    Was this useful?
    On this page

    On this page