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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
ذات صلة

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

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

مرجع الضبط

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