Müzik oluşturma

# Asenkron davranış

Oturum destekli müzik üretimi 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 takip eden bir ajan mesajında gönderir.
• Yinelenenleri ö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 kontrol etmek için action: "status" kullanın.
• Durum arama: openclaw tasks list veya openclaw tasks show <taskId> kuyrukta, çalışıyor ve terminal durumlarını inceler.
• Tamamlama uyandırması: OpenClaw, modelin kullanıcıya dönük takip mesajını kendisinin yazabilmesi için aynı oturuma dahili bir tamamlama olayı enjekte eder.
• Prompt 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 körü körüne tekrar music_generate ç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ü

CLI'dan durumu kontrol edin:

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

# Yapılandırma

# Model seçimi

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "google/lyria-3-clip-preview",
        fallbacks: ["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ından model parametresi (ajan bir tane belirtirse).
2. Yapılandırmadan musicGenerationModel.primary.
3. Sırayla musicGenerationModel.fallbacks.
4. Yalnızca kimlik doğrulama destekli sağlayıcı varsayılanlarıyla otomatik algılama:
   • önce mevcut varsayılan sağlayıcı;
   • kalan kayıtlı müzik üretme sağlayıcıları, sağlayıcı kimliği sırasına göre.

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

Yalnızca açık model, primary ve fallbacks girişlerini kullanmak için agents.defaults.mediaGenerationAutoProviderFallback: false ayarlayın.

# Sağlayıcı notları

# Doğru yolu seçme

• Ortak sağlayıcı destekli: Model seçimi, sağlayıcı failover'ı ve yerleşik asenkron görev/durum akışı istediğinizde.
• Plugin yolu (ComfyUI): Özel bir workflow grafiğine veya ortak paketlenmiş müzik yeteneğinin parçası olmayan bir sağlayıcıya ihtiyacınız olduğunda.

ComfyUI'ye özgü davranışta hata ayıklıyorsanız bkz. ComfyUI. Ortak sağlayıcı davranışında hata ayıklıyorsanız Google (Gemini) veya MiniMax ile başlayın.

# Sağlayıcı yetenek modları

Ortak müzik üretme sözleşmesi açık mod bildirimlerini destekler:

• Yalnızca prompt ile ü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. Sağlayıcılar generate ve edit öğelerini açıkça bildirmelidir; böylece canlı testler, sözleşme testleri ve ortak music_generate aracı mod desteğini deterministik olarak doğrulayabilir.

# Canlı testler

Ortak paketlenmiş sağlayıcılar için isteğe bağlı canlı kapsam:

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

Repo sarmalayıcısı:

pnpm test:live:media music

Bu canlı dosya eksik sağlayıcı env değişkenlerini ~/.profile öğesinden yükler, varsayılan olarak canlı/env API anahtarlarını depolanmış kimlik doğrulama profillerinin önüne alır ve sağlayıcı düzenleme modunu etkinleştirdiğinde hem generate hem de bildirilen edit kapsamını çalıştırır. Bugünkü kapsam:

• google: generate artı edit
• minimax: yalnızca generate
• comfy: paylaşılan sağlayıcı taraması değil, ayrı Comfy canlı kapsamı

Paketle 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ı dosyası, bu bölümler yapılandırıldığında comfy görüntü ve video iş akışlarını da kapsar.

# İlgili

• Arka plan görevleri — ayrılmış music_generate çalıştırmaları için görev takibi
• 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ış