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

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.

يضيف 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

تشغيل التهيئة الأولية التفاعلية

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

اختيار إمكانية افتراضية

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

​
الإمكانات

نموذج الصور الافتراضي:
  • 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}",
          voiceId: "21m00Tcm4TlvDq8ikWAM",
        },
      },
    },
  },
}
الإعدادات الافتراضية:
  • النموذج: elevenlabs/tts
  • معرّف الصوت: 21m00Tcm4TlvDq8ikWAM
يعرِض Plugin المضمّن حاليًا صوتًا افتراضيًا واحدًا معروفًا بجودته، ويعيد ملفات صوتية بصيغة MP3.

​
ذو صلة

دليل المزوّدين

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

توليد الصور

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

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

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

مرجع الإعدادات

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