الانتقال إلى المحتوى الرئيسي
يضيف Plugin Vydra المضمّن ما يلي:
  • توليد الصور عبر vydra/grok-imagine
  • توليد الفيديو عبر vydra/veo3 وvydra/kling
  • تركيب الكلام عبر مسار TTS المدعوم من ElevenLabs في Vydra
يستخدم OpenClaw نفس VYDRA_API_KEY للقدرات الثلاث كلها.
الخاصيةالقيمة
معرّف المزوّدvydra
Pluginمضمن، enabledByDefault: true
متغير بيئة المصادقةVYDRA_API_KEY
علامة الإعداد الأولي--auth-choice vydra-api-key
علامة CLI مباشرة--vydra-api-key <key>
العقودimageGenerationProviders, videoGenerationProviders, speechProviders
عنوان URL الأساسيhttps://www.vydra.ai/api/v1 (استخدم مضيف www)
استخدم https://www.vydra.ai/api/v1 كعنوان URL الأساسي. يعيد مضيف Vydra الجذري (https://vydra.ai/api/v1) التوجيه حاليًا إلى www. تسقط بعض عملاء HTTP ترويسة Authorization عند إعادة التوجيه هذه بين المضيفين، مما يحوّل مفتاح API صالحًا إلى فشل مصادقة مضلل. يستخدم Plugin المضمّن عنوان URL الأساسي www مباشرة لتجنب ذلك.

​
الإعداد

1

Run interactive onboarding

openclaw onboard --auth-choice vydra-api-key
أو عيّن متغير البيئة مباشرة:
export VYDRA_API_KEY="vydra_live_..."
2

Choose a default capability

اختر واحدة أو أكثر من القدرات أدناه (الصورة أو الفيديو أو الكلام) وطبّق الإعداد المطابق.

​
القدرات

نموذج الصور الافتراضي:
  • vydra/grok-imagine
عيّنه كمزوّد الصور الافتراضي:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "vydra/grok-imagine",
      },
    },
  },
}
الدعم المضمّن الحالي يقتصر على تحويل النص إلى صورة. تتوقع مسارات التحرير المستضافة في Vydra عناوين URL بعيدة للصور، ولا يضيف OpenClaw بعد جسر رفع خاصًا بـ Vydra في Plugin المضمّن.
راجع توليد الصور لمعلمات الأداة المشتركة، واختيار المزوّد، وسلوك تجاوز الفشل.
نماذج الفيديو المسجلة:
  • vydra/veo3 لتحويل النص إلى فيديو
  • vydra/kling لتحويل الصورة إلى فيديو
عيّن Vydra كمزوّد الفيديو الافتراضي:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "vydra/veo3",
      },
    },
  },
}
ملاحظات:
  • vydra/veo3 مضمّن لتحويل النص إلى فيديو فقط.
  • يتطلب vydra/kling حاليًا مرجع URL بعيدًا لصورة. تُرفض عمليات رفع الملفات المحلية مقدمًا.
  • كان مسار HTTP الحالي kling في Vydra غير متسق بشأن ما إذا كان يتطلب image_url أو video_url؛ يربط المزوّد المضمّن نفس عنوان URL البعيد للصورة بكلا الحقلين.
  • يبقى Plugin المضمّن محافظًا ولا يمرر مقابض نمط غير موثقة مثل نسبة العرض إلى الارتفاع أو الدقة أو العلامة المائية أو الصوت المولّد.
راجع توليد الفيديو لمعلمات الأداة المشتركة، واختيار المزوّد، وسلوك تجاوز الفشل.
تغطية مباشرة خاصة بالمزوّد:
OPENCLAW_LIVE_TEST=1 \
OPENCLAW_LIVE_VYDRA_VIDEO=1 \
pnpm test:live -- extensions/vydra/vydra.live.test.ts
يغطي ملف Vydra المباشر المضمّن الآن:
  • تحويل النص إلى فيديو عبر vydra/veo3
  • تحويل الصورة إلى فيديو عبر vydra/kling باستخدام عنوان URL بعيد لصورة
تجاوز عينة الصورة البعيدة عند الحاجة:
export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
عيّن Vydra كمزوّد الكلام:
{
  messages: {
    tts: {
      provider: "vydra",
      providers: {
        vydra: {
          apiKey: "${VYDRA_API_KEY}",
          speakerVoiceId: "21m00Tcm4TlvDq8ikWAM",
        },
      },
    },
  },
}
الإعدادات الافتراضية:
  • النموذج: elevenlabs/tts
  • معرّف الصوت: 21m00Tcm4TlvDq8ikWAM
يعرّض Plugin المضمّن حاليًا صوتًا افتراضيًا واحدًا معروفًا بجودته ويعيد ملفات صوتية بصيغة MP3.

​
ذات صلة

Provider directory

تصفح جميع المزوّدين المتاحين.

Image generation

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

Video generation

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

Configuration reference

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