​

إنشاء الفيديوهات

• generate لطلبات تحويل النص إلى فيديو بدون وسائط مرجعية
• imageToVideo عندما يتضمن الطلب صورة مرجعية واحدة أو أكثر
• videoToVideo عندما يتضمن الطلب مقطع فيديو مرجعيًا واحدًا أو أكثر

​

البدء السريع

1. عيّن مفتاح API لأي مزود مدعوم:

export GEMINI_API_KEY="your-key"

2. اختياريًا، ثبّت نموذجًا افتراضيًا:

openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1-fast-generate-preview"

3. اطلب من الوكيل:

أنشئ فيديو سينمائيًا مدته 5 ثوانٍ لكركند ودود يتزلج على الأمواج عند غروب الشمس.

​

ماذا يحدث عند إنشاء فيديو

1. يرسل OpenClaw الطلب إلى المزود ويعيد فورًا معرّف مهمة.
2. يعالج المزود المهمة في الخلفية (عادةً من 30 ثانية إلى 5 دقائق حسب المزود والدقة).
3. عندما يصبح الفيديو جاهزًا، يوقظ OpenClaw الجلسة نفسها عبر حدث إكمال داخلي.
4. ينشر الوكيل الفيديو النهائي مرة أخرى في المحادثة الأصلية.

​

دورة حياة المهمة

1. queued — تم إنشاء المهمة وهي بانتظار أن يقبلها المزود.
2. running — يعالج المزود المهمة (عادةً من 30 ثانية إلى 5 دقائق حسب المزود والدقة).
3. succeeded — أصبح الفيديو جاهزًا؛ يستيقظ الوكيل وينشره في المحادثة.
4. failed — خطأ من المزود أو انتهاء مهلة؛ يستيقظ الوكيل مع تفاصيل الخطأ.

openclaw tasks list
openclaw tasks show <taskId>
openclaw tasks cancel <taskId>

​

المزودون المدعومون

​

مصفوفة القدرات المعلنة

​

معلمات الأداة

​

مطلوبة

​

مدخلات المحتوى

​

عناصر التحكم في النمط

​

متقدمة

• بدون وسائط مرجعية: generate
• أي صورة مرجعية: imageToVideo
• أي فيديو مرجعي: videoToVideo
• لا تغيّر المدخلات الصوتية المرجعية الوضع الذي تم تحديده؛ بل تُطبَّق فوق أي وضع تحدده المراجع الصورية/الفيديوية، ولا تعمل إلا مع المزودات التي تعلن maxInputAudios

​

التبديل الاحتياطي والخيارات ذات الأنواع المحددة

• إذا لم يعلن المرشح النشط عن maxInputAudios (أو أعلن عنها على أنها 0)، فسيتم تخطيه عندما يحتوي الطلب على مراجع صوتية، وتتم تجربة المرشح التالي.
• إذا كانت maxDurationSeconds لدى المرشح النشط أقل من durationSeconds المطلوبة ولم يعلن المرشح عن قائمة supportedDurationSeconds، فسيتم تخطيه.
• إذا كان الطلب يحتوي على providerOptions وكان المرشح النشط يعلن صراحة عن مخطط providerOptions ذي أنواع محددة، فسيتم تخطي المرشح عندما لا تكون المفاتيح الموردة موجودة في المخطط أو عندما لا تتطابق أنواع القيم. أما المزودات التي لم تعلن عن مخطط بعد فتتلقى الخيارات كما هي (تمرير متوافق مع الإصدارات السابقة). ويمكن للمزود إلغاء قبول جميع خيارات المزود صراحة عبر إعلان مخطط فارغ (capabilities.providerOptions: {})، مما يؤدي إلى نفس التخطي الناتج عن عدم تطابق النوع.

​

الإجراءات

• generate (افتراضي) — إنشاء فيديو من المطالبة المعطاة والمدخلات المرجعية الاختيارية.
• status — التحقق من حالة مهمة الفيديو الجارية للجلسة الحالية دون بدء إنشاء آخر.
• list — عرض المزودات والنماذج المتاحة وقدراتها.

​

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

1. معلمة الأداة model — إذا حددها الوكيل في الاستدعاء.
2. videoGenerationModel.primary — من التكوين.
3. videoGenerationModel.fallbacks — تُجرَّب بالترتيب.
4. الاكتشاف التلقائي — يستخدم المزودات التي لديها مصادقة صالحة، بدءًا من المزود الافتراضي الحالي، ثم المزودات المتبقية بترتيب أبجدي.

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "google/veo-3.1-fast-generate-preview",
        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],
      },
    },
  },
}

​

ملاحظات حول المزودين

​

أوضاع قدرات المزود

capabilities: {
  generate: {
    maxVideos: 1,
    maxDurationSeconds: 10,
    supportsResolution: true,
  },
  imageToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputImages: 1,
    maxDurationSeconds: 5,
  },
  videoToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputVideos: 1,
    maxDurationSeconds: 5,
  },
}

​

الاختبارات الحية

OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/video-generation-providers.live.test.ts

pnpm test:live:media video

• generate لكل مزود في الفحص
• imageToVideo عندما تكون capabilities.imageToVideo.enabled
• videoToVideo عندما تكون capabilities.videoToVideo.enabled ويقبل المزود/النموذج إدخال الفيديو المحلي المعتمد على المخزن المؤقت في الفحص المشترك

• runway فقط عند اختيار runway/gen4_aleph

​

التكوين

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "qwen/wan2.6-t2v",
        fallbacks: ["qwen/wan2.6-r2v-flash"],
      },
    },
  },
}

openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2v"

​

ذو صلة

• نظرة عامة على الأدوات
• المهام في الخلفية — تتبع المهام لإنشاء الفيديوهات غير المتزامن
• Alibaba Model Studio
• BytePlus
• ComfyUI
• fal
• Google (Gemini)
• MiniMax
• OpenAI
• Qwen
• Runway
• Together AI
• Vydra
• xAI
• مرجع التكوين
• النماذج