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

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

export SGLANG_API_KEY="sglang-local"

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

openclaw onboard

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

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

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

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

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

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

إذا عيّنت models.providers.sglang صراحةً، فسيستخدم OpenClaw نماذجك المعلنة افتراضيًا. أضف "sglang/*": {} إلى agents.defaults.models عندما تريد من OpenClaw الاستعلام عن نقطة النهاية /models لذلك المزوّد المُهيّأ وتضمين جميع نماذج SGLang المُعلن عنها.

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

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

تعمل SGLang على مضيف أو منفذ مختلف.
تريد تثبيت قيم contextWindow/maxTokens.
يتطلب خادمك مفتاح API حقيقيًا (أو تريد التحكم في الترويسات).

{
  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

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

يتعذر الوصول إلى الخادمتحقّق من أن الخادم يعمل ويستجيب:

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

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

إذا شغّلت SGLang من دون مصادقة، فتكفي أي قيمة غير فارغة لـ SGLANG_API_KEY للاشتراك في اكتشاف النماذج.

ذو صلة

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

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

مرجع التهيئة

مخطط التهيئة الكامل، بما في ذلك إدخالات المزوّدين.

Overview

Concepts and configuration

Providers

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

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

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

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

ذو صلة

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

مرجع التهيئة

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

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

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

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

​ذو صلة

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

مرجع التهيئة

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

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

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

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

ذو صلة