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

​

البدء السريع

{
  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: ["fal/fal-ai/minimax-music/v2.6", "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
• fal: ‏generate فقط
• minimax: ‏generate فقط
• openrouter: ‏generate بالإضافة إلى edit
• 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
• النماذج — إعداد النماذج والتبديل الاحتياطي
• نظرة عامة على الأدوات