Müzik üretimi

Müzik oluşturma 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ılma değeri (ö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örsel yolu veya URL'si.

Birden fazla referans görsel (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.mediaModels.music.timeoutMs 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 oluşturma işlemi 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ı iletisinde gönderir.
• Yinelenenleri önleme: Bir görev queued veya running durumundayken aynı oturumdaki sonraki music_generate çağrıları başka bir oluşturma 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 yinelenen istek olarak elenir.
• Durum sorgulama: openclaw tasks list veya openclaw tasks show <taskId>, kuyruğa alınmış, çalışan ve sonlanmış durumları inceler.
• Tamamlama uyandırması: OpenClaw, modelin kullanıcıya yönelik takip iletisini kendisinin yazabilmesi için aynı oturuma dahili bir tamamlama olayı ekler.
• İstem ipucu: Aynı oturumdaki sonraki kullanıcı/manuel turlar, bir müzik görevi zaten devam ediyorsa küçük bir çalışma zamanı ipucu alır; böylece model music_generate aracını düşünmeden tekrar çağırmaz.
• Oturumsuz geri dönüş: Gerçek bir ajan oturumu olmayan doğrudan/yerel bağlamlar, işlemi satır içi çalıştırır ve son ses sonucunu aynı turda döndürür.

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

Müzik görevi, genel görev kayıt defteriyle aynı durumları sunar (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çim 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ırayla musicGenerationModel.fallbacks.
4. Yalnızca kimlik doğrulama destekli sağlayıcı varsayılanlarını kullanan otomatik algılama:
   • müzik oluşturma da sunuyorsa önce geçerli varsayılan metin modeli sağlayıcısı;
   • ardından kalan kayıtlı müzik oluşturma sağlayıcıları, sağlayıcı kimliğine göre alfabetik sırayla.

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.

Kimliği doğrulanmış sağlayıcılar arasında otomatik geri dönüş her zaman etkindir. Çağrı başına model belirleyici olmaya devam eder.

Sağlayıcı notları

Doğru yolu seçme

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

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 oluşturma sözleşmesi açık mod bildirimlerini destekler:

• Yalnızca istemle oluşturma için generate.
• İstek bir veya daha fazla referans görseli 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. Sağlayıcılar; canlı testlerin, sözleşme testlerinin ve paylaşılan music_generate aracının mod desteğini belirlenimci biçimde doğrulayabilmesi için generate ve edit değerlerini açıkça bildirmelidir.

Canlı testler

Paylaşılan ve birlikte sunulan 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ı dosya, varsayılan olarak saklanan kimlik doğrulama profillerinden önce önceden dışa aktarılmış sağlayıcı ortam değişkenlerini kullanır ve sağlayıcı düzenleme modunu etkinleştirdiğinde hem generate hem de bildirilmiş 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ının parçası olmayan ayrı Comfy canlı kapsamı

Birlikte sunulan 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ı 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ı için görev izleme
• ComfyUI
• Yapılandırma referansı — musicGenerationModel yapılandırması
• Google (Gemini)
• MiniMax
• Modeller — model yapılandırması ve yük devretme
• Araçlara genel bakış