Providers
استوديو نماذج Alibaba
يسجّل Plugin alibaba المضمّن موفّرًا لتوليد الفيديو لنماذج Wan على Alibaba Model Studio (الاسم الدولي لـ DashScope). وهو مفعّل افتراضيًا؛ ولا يلزم سوى مفتاح 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 |
بدء الاستخدام
تعيين مفتاح API
خزّن المفتاح لدى الموفّر 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-...# أو DASHSCOPE_API_KEY=...# أو QWEN_API_KEY=...تعيين نموذج فيديو افتراضي
{ agents: { defaults: { videoGenerationModel: { primary: "alibaba/wan2.6-t2v", }, }, },}التحقق من إعداد الموفّر
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 |
تحويل المرجع إلى فيديو |
الإمكانات والحدود
تشترك الأوضاع الثلاثة جميعها في الحد نفسه لعدد مقاطع الفيديو ومدة الفيديو لكل طلب؛ ويختلف شكل الإدخال فقط.
| الوضع | الحد الأقصى لمقاطع الفيديو الناتجة | الحد الأقصى لصور الإدخال | الحد الأقصى لمقاطع فيديو الإدخال | المدة القصوى | عناصر التحكم المدعومة |
|---|---|---|---|---|---|
| تحويل النص إلى فيديو | 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 ثوانٍ.
الإعداد المتقدم
تجاوز عنوان URL الأساسي لـ DashScope
يستخدم الموفّر افتراضيًا نقطة نهاية DashScope الدولية. لاستهداف نقطة النهاية الخاصة بمنطقة الصين:
{ models: { providers: { alibaba: { baseUrl: "https://dashscope.aliyuncs.com", }, }, },}يزيل الموفّر الشرطات المائلة اللاحقة قبل إنشاء عناوين URL لمهام AIGC.
أولوية متغيرات بيئة المصادقة
يعثر OpenClaw على مفتاح API الخاص بـ Alibaba من متغيرات البيئة وفق الترتيب التالي، ويعتمد أول قيمة غير فارغة:
MODELSTUDIO_API_KEYDASHSCOPE_API_KEYQWEN_API_KEY
تتجاوز إدخالات auth.profiles المُعدّة (التي تُعيّن عبر openclaw models auth login) آلية العثور على القيمة من متغيرات البيئة. راجع ملفات تعريف المصادقة في الأسئلة الشائعة حول النماذج للتعرّف على آليات تدوير ملفات التعريف وفترة التهدئة والتجاوز.
العلاقة مع Plugin Qwen
يتصل كلا الـ Plugin المضمّنين بـ DashScope ويقبلان مفاتيح API متداخلة. استخدم:
- معرّفات
alibaba/wan*.*لموفّر فيديو Wan المخصص والموثّق في هذه الصفحة. - معرّفات
qwen/*لمحادثة Qwen والتضمين وفهم الوسائط (راجع Qwen).
يؤدي تعيين MODELSTUDIO_API_KEY مرة واحدة إلى مصادقة كلا الـ Plugin، لأن قائمة متغيرات بيئة المصادقة متداخلة عن قصد؛ ولا يلزم إجراء الإعداد الأولي لكل Plugin على حدة.