Müzik üretimi

Müzik üretme istemi. action: "generate" için gereklidir.

"status" geçerli oturum görevini döndürür; "list" sağlayıcıları inceler.

Sağlayıcı/model geçersiz kılması (ör. google/lyria-3-pro-preview, comfy/workflow).

Sağlayıcı açık şarkı sözü girdisini desteklediğinde isteğe bağlı şarkı sözleri.

Sağlayıcı desteklediğinde yalnızca enstrümantal çıktı isteyin.

Tek referans görselinin yolu veya URL'si.

Birden fazla referans görseli (destekleyen sağlayıcılarda en fazla 10).

Sağlayıcı süre ipuçlarını desteklediğinde saniye cinsinden hedef süre.

Sağlayıcı desteklediğinde çıktı biçimi ipucu.

Sağlayıcı istek zaman aşımları yalnızca operatör yapılandırmasıdır. OpenClaw, yapılandırıldığında agents.defaults.musicGenerationModel.timeoutMs değerini kullanır, 120000ms altındaki değerleri 120000ms değerine yükseltir ve aksi durumda sağlayıcı istekleri için varsayılan olarak 300000ms kullanır.

Eşzamansız davranış

Oturum destekli müzik üretimi bir arka plan görevi olarak çalışır:

• Arka plan görevi: music_generate bir arka plan görevi oluşturur, başlatıldı/görev yanıtını hemen döndürür ve tamamlanan parçayı daha sonra bir takip ajan mesajında gönderir.
• Yinelemeyi önleme: Bir görev queued veya running durumundayken aynı oturumdaki sonraki music_generate çağrıları başka bir üretim başlatmak yerine görev durumunu döndürür. Açıkça denetlemek için action: "status" kullanın. Yakın zamanda tamamlanmış eşleşen bir istek de 2 dakika boyunca yinelenmez.
• Durum sorgulama: openclaw tasks list veya openclaw tasks show <taskId>, sıraya alınmış, çalışan ve sonlandırılmış durumları inceler.
• Tamamlama uyandırması: OpenClaw, modelin kullanıcıya yönelik takip mesajını kendisinin yazabilmesi için aynı oturuma bir dahili tamamlama olayı ekler.
• İstem ipucu: Aynı oturumdaki sonraki kullanıcı/manuel turlarında, bir müzik görevi zaten devam ediyorsa modele küçük bir çalışma zamanı ipucu verilir; böylece model music_generate aracını körü körüne yeniden çağırmaz.
• Oturumsuz geri dönüş: Gerçek bir ajan oturumu olmayan doğrudan/yerel bağlamlar satır içi çalışır ve nihai ses sonucunu aynı turda döndürür.

Görev yaşam döngüsü

Müzik görevi, genel görev kaydıyla aynı durumları gösterir (timed_out, cancelled ve lost dâhil tam durum makinesi için bkz. Arka plan görevleri). Çoğu müzik çalıştırması şu durumlardan geçer:

Durumu CLI üzerinden denetleyin:

openclaw tasks listopenclaw tasks show <taskId>openclaw tasks cancel <taskId>

Yapılandırma

Model seçimi

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

Sağlayıcı seçme sırası

OpenClaw sağlayıcıları şu sırayla dener:

1. Araç çağrısındaki model parametresi (ajan bir tane belirtirse).
2. Yapılandırmadaki musicGenerationModel.primary.
3. Sırasıyla musicGenerationModel.fallbacks.
4. Yalnızca kimlik doğrulama destekli sağlayıcı varsayılanlarını kullanarak otomatik algılama:
   • müzik üretimi de sunuyorsa önce geçerli varsayılan metin modeli sağlayıcısı;
   • kalan kayıtlı müzik üretme sağlayıcıları, sağlayıcı kimliğine göre alfabetik sırada.

Bir sağlayıcı başarısız olursa sonraki aday otomatik olarak denenir. Tümü başarısız olursa hata, her denemenin ayrıntılarını içerir.

Yalnızca açık model, primary ve fallbacks girdilerini kullanmak için agents.defaults.mediaGenerationAutoProviderFallback: false ayarını yapın.

Sağlayıcı notları

Doğru yolu seçme

• Model seçimi, sağlayıcı yük devri ve yerleşik eşzamansız görev/durum akışını istediğinizde paylaşılan sağlayıcı destekli yol.
• Özel bir iş akışı grafiğine veya paylaşılan ve birlikte gelen müzik yeteneğinin parçası olmayan bir sağlayıcıya ihtiyaç duyduğunuzda Plugin yolu (ComfyUI).

ComfyUI'ye özgü davranışlarda hata ayıklıyorsanız ComfyUI sayfasına bakın. Paylaşılan sağlayıcı davranışında hata ayıklıyorsanız fal, Google (Gemini), MiniMax veya OpenRouter ile başlayın.

Sağlayıcı yetenek modları

Paylaşılan müzik üretimi sözleşmesi, açık mod bildirimlerini destekler:

• Yalnızca istemle üretim için generate.
• İstek bir veya daha fazla referans görsel içerdiğinde edit.

Yeni sağlayıcı uygulamaları açık mod bloklarını tercih etmelidir:

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

maxInputImages, supportsLyrics ve supportsFormat gibi eski düz alanlar, düzenleme desteğini duyurmak için yeterli değildir. Canlı testlerin, sözleşme testlerinin ve paylaşılan music_generate aracının mod desteğini belirlenimci biçimde doğrulayabilmesi için sağlayıcılar generate ile edit modlarını açıkça bildirmelidir.

Canlı testler

Paylaşılan ve birlikte gelen sağlayıcılar (fal, Google, MiniMax, OpenRouter) için isteğe bağlı canlı kapsam:

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

Aynı test dosyasını çalıştıran eşdeğer depo sarmalayıcısı:

pnpm test:live:media:music

Bu canlı test dosyası, varsayılan olarak saklanan kimlik doğrulama profillerinden önce dışa aktarılmış mevcut sağlayıcı ortam değişkenlerini kullanır ve sağlayıcı düzenleme modunu etkinleştirdiğinde hem generate hem de bildirilen edit kapsamını çalıştırır. Güncel kapsam:

• google: generate ve edit
• fal: yalnızca generate
• minimax: yalnızca generate
• openrouter: generate ve edit
• comfy: paylaşılan sağlayıcı taramasından ayrı Comfy canlı kapsamı

Birlikte gelen ComfyUI müzik yolu için isteğe bağlı canlı kapsam:

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

Comfy canlı test dosyası, ilgili bölümler yapılandırıldığında Comfy görsel ve video iş akışlarını da kapsar.

İlgili

• Arka plan görevleri — ayrılmış music_generate çalıştırmalarının görev takibi
• ComfyUI
• Yapılandırma başvurusu — musicGenerationModel yapılandırması
• Google (Gemini)
• MiniMax
• Modeller — model yapılandırması ve yük devri
• Araçlara genel bakış