Providers
Alibaba Model Studio
OpenClaw يوفّر Plugin مضمّنًا باسم alibaba يسجّل موفّرًا لتوليد الفيديو لنماذج Wan على Alibaba Model Studio (الاسم الدولي لـ DashScope). يكون الـ Plugin مفعّلًا افتراضيًا؛ ما عليك سوى تعيين مفتاح API.
| الخاصية | القيمة |
|---|---|
| معرّف الموفّر | alibaba |
| Plugin | مضمّن، enabledByDefault: true |
| متغيرات بيئة المصادقة | MODELSTUDIO_API_KEY → DASHSCOPE_API_KEY → QWEN_API_KEY (أول تطابق يفوز) |
| علامة الإعداد الأولي | --auth-choice alibaba-model-studio-api-key |
| علامة CLI المباشرة | --alibaba-model-studio-api-key <key> |
| النموذج الافتراضي | alibaba/wan2.6-t2v |
| عنوان URL الأساسي الافتراضي | https://dashscope-intl.aliyuncs.com |
البدء
Set an API key
استخدم الإعداد الأولي لتخزين المفتاح مقابل موفّر alibaba:
openclaw onboard --auth-choice alibaba-model-studio-api-key
أو مرّر المفتاح مباشرة أثناء التثبيت/الإعداد الأولي:
openclaw onboard --alibaba-model-studio-api-key <your-key>
أو صدّر أيًا من متغيرات البيئة المقبولة قبل بدء Gateway:
export MODELSTUDIO_API_KEY=sk-...
# or DASHSCOPE_API_KEY=...
# or QWEN_API_KEY=...
Set a default video model
{
agents: {
defaults: {
videoGenerationModel: {
primary: "alibaba/wan2.6-t2v",
},
},
},
}
Verify the provider is configured
openclaw models list --provider alibaba
يجب أن تتضمن القائمة جميع نماذج Wan الخمسة المضمّنة. إذا لم يتم حل MODELSTUDIO_API_KEY، فإن openclaw models status --json يبلّغ عن بيانات الاعتماد المفقودة ضمن auth.unusableProfiles.
نماذج Wan المضمّنة
| مرجع النموذج | الوضع |
|---|---|
alibaba/wan2.6-t2v |
نص إلى فيديو (افتراضي) |
alibaba/wan2.6-i2v |
صورة إلى فيديو |
alibaba/wan2.6-r2v |
مرجع إلى فيديو |
alibaba/wan2.6-r2v-flash |
مرجع إلى فيديو (سريع) |
alibaba/wan2.7-r2v |
مرجع إلى فيديو |
القدرات والحدود
يعكس الموفّر المضمّن حدود واجهة API لفيديو Wan في DashScope. تشترك الأوضاع الثلاثة كلها في عدد الفيديوهات لكل طلب وحد مدة الفيديو نفسه؛ ويختلف شكل الإدخال فقط.
| الوضع | الحد الأقصى للفيديوهات الناتجة | الحد الأقصى لصور الإدخال | الحد الأقصى لفيديوهات الإدخال | الحد الأقصى للمدة | عناصر التحكم المدعومة |
|---|---|---|---|---|---|
| نص إلى فيديو | 1 | غير متاح | غير متاح | 10 ث | size, aspectRatio, resolution, audio, watermark |
| صورة إلى فيديو | 1 | 1 | غير متاح | 10 ث | size, aspectRatio, resolution, audio, watermark |
| مرجع إلى فيديو | 1 | غير متاح | 4 | 10 ث | size, aspectRatio, resolution, audio, watermark |
عندما لا يضمّن الطلب durationSeconds، يرسل الموفّر القيمة الافتراضية المقبولة لدى DashScope وهي 5 ثوانٍ. عيّن durationSeconds صراحةً في أداة توليد الفيديو للتمديد حتى 10 ثوانٍ.
الإعدادات المتقدمة
Override the DashScope base URL
يستخدم الموفّر نقطة نهاية DashScope الدولية افتراضيًا. لاستهداف نقطة نهاية منطقة الصين، عيّن:
{
models: {
providers: {
alibaba: {
baseUrl: "https://dashscope.aliyuncs.com",
},
},
},
}
يزيل الموفّر الشرطات المائلة اللاحقة قبل إنشاء عناوين URL لمهام AIGC.
Auth env priority
يحل OpenClaw مفتاح API الخاص بـ Alibaba من متغيرات البيئة بهذا الترتيب، مع أخذ أول قيمة غير فارغة:
MODELSTUDIO_API_KEYDASHSCOPE_API_KEYQWEN_API_KEY
تتجاوز إدخالات auth.profiles المضبوطة (عبر openclaw models auth login) حل متغيرات البيئة. راجع ملفات تعريف المصادقة في الأسئلة الشائعة للنماذج لمعرفة آليات تدوير الملفات الشخصية وفترات التهدئة والتجاوز.
Relationship to the Qwen plugin
يتصل كلا الـ Pluginين المضمّنين بـ DashScope ويقبلان مفاتيح API متداخلة. استخدم:
- معرّفات
alibaba/wan*.*لتشغيل موفّر فيديو Wan المخصص الموثّق في هذه الصفحة. - معرّفات
qwen/*لدردشة Qwen والتضمين وفهم الوسائط (راجع Qwen).
تعيين MODELSTUDIO_API_KEY مرة واحدة يصادق كلا الـ Pluginين لأن قائمة متغيرات بيئة المصادقة تتداخل عمدًا؛ لست بحاجة إلى إعداد كل Plugin على حدة.