​

توليد الفيديو

• 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

​

الإجراءات

• 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
• مرجع الإعدادات
• النماذج