​

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

​

البدء السريع

​

التوليد المدعوم بمزودات مشتركة

1. اضبط مفتاح API لمزود واحد على الأقل، مثل GEMINI_API_KEY أو MINIMAX_API_KEY.
2. اضبط نموذجك المفضل اختياريًا:

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

3. اطلب من الوكيل: “أنشئ مقطع synthpop حيويًا عن قيادة ليلية عبر مدينة نيون.”

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

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

​

توليد Comfy المعتمد على سير العمل

1. هيّئ models.providers.comfy.music باستخدام JSON لسير العمل و عقد prompt/output.
2. إذا كنت تستخدم Comfy Cloud، فاضبط COMFY_API_KEY أو COMFY_CLOUD_API_KEY.
3. اطلب من الوكيل إنشاء موسيقى أو استدعِ الأداة مباشرةً.

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

​

دعم المزودات المضمنة المشتركة

​

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

/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 حدث اكتمال داخليًا مرة أخرى في الجلسة نفسها حتى يتمكن النموذج من كتابة رسالة المتابعة الموجهة للمستخدم بنفسه.
• تلميح prompt: تحصل أدوار المستخدم/الأدوار اليدوية اللاحقة في الجلسة نفسها على تلميح صغير في وقت التشغيل عندما تكون مهمة موسيقى قيد التنفيذ بالفعل حتى لا يستدعي النموذج music_generate مرة أخرى بشكل أعمى.
• fallback بدون جلسة: لا تزال السياقات المباشرة/المحلية بدون جلسة وكيل حقيقية تعمل بشكل مضمّن وتعيد نتيجة الصوت النهائية في الدور نفسه.

​

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

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

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

​

الإعدادات

​

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

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

​

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

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

​

ملاحظات خاصة بالمزودات

• يستخدم Google توليد Lyria 3 الدفعي. ويدعم التدفق المضمن الحالي prompt، ونص كلمات اختياري، وصورًا مرجعية اختيارية.
• يستخدم MiniMax نقطة النهاية الدفعية music_generation. ويدعم التدفق المضمن الحالي prompt، وكلمات اختيارية، ووضعًا آليًا فقط، وتوجيه المدة، و إخراج mp3.
• دعم ComfyUI يعتمد على سير العمل ويعتمد على الرسم البياني المضبوط بالإضافة إلى تعيين العقد لحقول prompt/output.

​

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

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

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

​

اختيار المسار المناسب

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

​

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

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 المنفصلة
• مرجع الإعدادات - إعدادات musicGenerationModel
• ComfyUI
• Google (Gemini)
• MiniMax
• النماذج - إعدادات النماذج وfailover
• نظرة عامة على الأدوات