الانتقال إلى المحتوى الرئيسي
توفّر SGLang النماذج مفتوحة الأوزان عبر واجهة API HTTP متوافقة مع 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. راجع اكتشاف النموذج (مزوّد ضمني) أدناه.

​
البدء

1

ابدأ SGLang

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

عيّن مفتاح API

تعمل أي قيمة إذا لم تكن المصادقة مضبوطة على خادمك:
export SGLANG_API_KEY="sglang-local"
3

شغّل التهيئة الأولية أو عيّن نموذجًا مباشرة

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 تكفي لاختيار اكتشاف النماذج.

​
ذات صلة

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

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

مرجع الضبط

مخطط الضبط الكامل بما في ذلك إدخالات المزوّدين.