توليد الموسيقى

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.

​

البدء السريع

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "google/lyria-3-clip-preview",
      },
    },
  },
}

/tool music_generate prompt="Warm ambient synth loop with soft tape texture"

Generate a cinematic piano track with soft strings and no vocals.

Generate an energetic chiptune loop about launching a rocket at sunrise.

​

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

​

مصفوفة الإمكانات

/tool music_generate action=list

/tool music_generate action=status

/tool music_generate prompt="Dreamy lo-fi hip hop with vinyl texture and gentle rain" instrumental=true

​

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

​

السلوك غير المتزامن

• مهمة خلفية: تنشئ music_generate مهمة خلفية، وتعيد استجابة بدء/مهمة فورًا، وتنشر المسار النهائي لاحقًا في رسالة متابعة من الوكيل.
• منع التكرار: بينما تكون المهمة queued أو running، تعيد استدعاءات music_generate اللاحقة في الجلسة نفسها حالة المهمة بدلًا من بدء توليد آخر. استخدم action: "status" للتحقق صراحة.
• بحث الحالة: يفحص openclaw tasks list أو openclaw tasks show <taskId> حالات الانتظار والتشغيل والحالات النهائية.
• تنبيه الإكمال: يحقن OpenClaw حدث إكمال داخليًا مرة أخرى في الجلسة نفسها حتى يستطيع النموذج كتابة المتابعة الظاهرة للمستخدم بنفسه.
• تلميح المطالبة: تحصل أدوار المستخدم/الأدوار اليدوية اللاحقة في الجلسة نفسها على تلميح تشغيل صغير عندما تكون مهمة موسيقى قيد التنفيذ بالفعل، حتى لا يستدعي النموذج music_generate مرة أخرى دون داع.
• رجوع دون جلسة: تعمل السياقات المباشرة/المحلية دون جلسة وكيل حقيقية بشكل مضمّن وتعيد نتيجة الصوت النهائية في الدور نفسه.

​

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

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

​

التكوين

​

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

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "google/lyria-3-clip-preview",
        fallbacks: ["minimax/music-2.6"],
      },
    },
  },
}

​

ترتيب اختيار المزوّد

1. معامل model من استدعاء الأداة (إذا حدده الوكيل).
2. musicGenerationModel.primary من التكوين.
3. musicGenerationModel.fallbacks بالترتيب.
4. الاكتشاف التلقائي باستخدام افتراضيات المزوّد المدعومة بالمصادقة فقط:
   • المزوّد الافتراضي الحالي أولًا؛
   • بقية مزوّدي توليد الموسيقى المسجلين بترتيب معرّف المزوّد.

​

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

​

اختيار المسار الصحيح

• مدعوم بمزوّد مشترك عندما تريد اختيار النموذج، وتجاوز فشل المزوّد، وتدفق المهمة/الحالة غير المتزامن المضمّن.
• مسار Plugin (ComfyUI) عندما تحتاج إلى رسم بياني مخصص لسير العمل أو مزوّد ليس جزءًا من إمكانية الموسيقى المضمّنة المشتركة.

​

أوضاع إمكانات المزوّد

• generate للتوليد من مطالبة فقط.
• edit عندما يتضمن الطلب صورة مرجعية واحدة أو أكثر.

capabilities: {
  generate: {
    maxTracks: 1,
    supportsLyrics: true,
    supportsFormat: true,
  },
  edit: {
    enabled: true,
    maxTracks: 1,
    maxInputImages: 1,
    supportsFormat: true,
  },
}

​

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

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

pnpm test:live:media music

• google: generate بالإضافة إلى edit
• minimax: generate فقط
• comfy: تغطية حية منفصلة لـ Comfy، وليست ضمن المسح المشترك للمزوّدين

OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts

​

ذات صلة

• مهام الخلفية — تتبّع المهام لتشغيلات music_generate المنفصلة
• ComfyUI
• مرجع التهيئة — تهيئة musicGenerationModel
• Google (Gemini)
• MiniMax
• النماذج — تهيئة النماذج والتبديل عند الفشل
• نظرة عامة على الأدوات