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

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.

OpenClaw يوفّر Plugin مضمّنًا باسم alibaba يسجّل موفّرًا لتوليد الفيديو لنماذج Wan على Alibaba Model Studio (الاسم الدولي لـ DashScope). يكون الـ Plugin مفعّلًا افتراضيًا؛ ما عليك سوى تعيين مفتاح API.
الخاصيةالقيمة
معرّف الموفّرalibaba
Pluginمضمّن، enabledByDefault: true
متغيرات بيئة المصادقةMODELSTUDIO_API_KEYDASHSCOPE_API_KEYQWEN_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

البدء

1

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=...
2

Set a default video model

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "alibaba/wan2.6-t2v",
      },
    },
  },
}
3

Verify the provider is configured

openclaw models list --provider alibaba
يجب أن تتضمن القائمة جميع نماذج Wan الخمسة المضمّنة. إذا لم يتم حل MODELSTUDIO_API_KEY، فإن openclaw models status --json يبلّغ عن بيانات الاعتماد المفقودة ضمن auth.unusableProfiles.
يتوثّق كل من Plugin Alibaba وPlugin Qwen مقابل DashScope ويقبلان متغيرات بيئة متداخلة. استخدم معرّفات النماذج alibaba/... لتشغيل سطح فيديو Wan المخصص؛ واستخدم معرّفات qwen/... عندما تريد سطح الدردشة أو التضمين أو فهم الوسائط الخاص بـ Qwen.

نماذج 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
صورة إلى فيديو11غير متاح10 ثsize, aspectRatio, resolution, audio, watermark
مرجع إلى فيديو1غير متاح410 ثsize, aspectRatio, resolution, audio, watermark
عندما لا يضمّن الطلب durationSeconds، يرسل الموفّر القيمة الافتراضية المقبولة لدى DashScope وهي 5 ثوانٍ. عيّن durationSeconds صراحةً في أداة توليد الفيديو للتمديد حتى 10 ثوانٍ.
يجب أن تكون إدخالات الصور والفيديو المرجعية عناوين URL بعيدة من نوع http(s). لا تقبل أوضاع المرجع في DashScope مسارات الملفات المحلية؛ ارفعها إلى تخزين كائنات أولًا أو استخدم مسار أداة الوسائط الذي ينتج عنوان URL عامًا بالفعل.

الإعدادات المتقدمة

يستخدم الموفّر نقطة نهاية DashScope الدولية افتراضيًا. لاستهداف نقطة نهاية منطقة الصين، عيّن:
{
  models: {
    providers: {
      alibaba: {
        baseUrl: "https://dashscope.aliyuncs.com",
      },
    },
  },
}
يزيل الموفّر الشرطات المائلة اللاحقة قبل إنشاء عناوين URL لمهام AIGC.
يحل OpenClaw مفتاح API الخاص بـ Alibaba من متغيرات البيئة بهذا الترتيب، مع أخذ أول قيمة غير فارغة:
  1. MODELSTUDIO_API_KEY
  2. DASHSCOPE_API_KEY
  3. QWEN_API_KEY
تتجاوز إدخالات auth.profiles المضبوطة (عبر openclaw models auth login) حل متغيرات البيئة. راجع ملفات تعريف المصادقة في الأسئلة الشائعة للنماذج لمعرفة آليات تدوير الملفات الشخصية وفترات التهدئة والتجاوز.
يتصل كلا الـ Pluginين المضمّنين بـ DashScope ويقبلان مفاتيح API متداخلة. استخدم:
  • معرّفات alibaba/wan*.* لتشغيل موفّر فيديو Wan المخصص الموثّق في هذه الصفحة.
  • معرّفات qwen/* لدردشة Qwen والتضمين وفهم الوسائط (راجع Qwen).
تعيين MODELSTUDIO_API_KEY مرة واحدة يصادق كلا الـ Pluginين لأن قائمة متغيرات بيئة المصادقة تتداخل عمدًا؛ لست بحاجة إلى إعداد كل Plugin على حدة.

ذات صلة

Video generation

معلمات أداة الفيديو المشتركة واختيار الموفّر.

Qwen

إعداد دردشة Qwen والتضمين وفهم الوسائط باستخدام مصادقة DashScope نفسها.

Configuration reference

الإعدادات الافتراضية للوكلاء وإعدادات النماذج.

Models FAQ

ملفات تعريف المصادقة، وتبديل النماذج، وحل أخطاء “no profile”.