​

Müzik Üretimi

​

Hızlı başlangıç

​

Paylaşılan sağlayıcı destekli üretim

1. En az bir sağlayıcı için bir API anahtarı ayarlayın; örneğin GEMINI_API_KEY veya MINIMAX_API_KEY.
2. İsteğe bağlı olarak tercih ettiğiniz modeli ayarlayın:

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

3. Agent’a şunu söyleyin: “Neon bir şehirde gece sürüşü hakkında enerjik bir synthpop parçası üret.”

Vokalsiz, yumuşak yaylılarla sinematik bir piyano parçası üret.

Gün doğumunda bir roket fırlatmak hakkında enerjik bir chiptune döngüsü üret.

​

Workflow odaklı Comfy üretimi

1. models.providers.comfy.music bölümünü bir workflow JSON’u ve prompt/çıktı düğümleriyle yapılandırın.
2. Comfy Cloud kullanıyorsanız, COMFY_API_KEY veya COMFY_CLOUD_API_KEY ayarlayın.
3. Agent’tan müzik isteyin veya aracı doğrudan çağırın.

/tool music_generate prompt="Yumuşak teyp dokusuna sahip sıcak ambient synth döngüsü"

​

Paylaşılan paketlenmiş sağlayıcı desteği

​

Bildirilmiş yetenek matrisi

/tool music_generate action=list

/tool music_generate action=status

/tool music_generate prompt="Vinil dokusu ve hafif yağmurla rüya gibi lo-fi hip hop" instrumental=true

​

Yerleşik araç parametreleri

​

Paylaşılan sağlayıcı destekli yol için asenkron davranış

• Oturum destekli agent çalıştırmaları: music_generate bir arka plan görevi oluşturur, hemen bir başlatıldı/görev yanıtı döndürür ve tamamlanan parçayı daha sonra takip eden bir agent mesajında gönderir.
• Yinelenenleri önleme: bu arka plan görevi hâlâ 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.
• Durum sorgulama: yeni bir üretim başlatmadan etkin oturum destekli müzik görevini incelemek için action: "status" kullanın.
• Görev izleme: üretim için sıraya alınmış, çalışan ve son duruma ulaşmış görevleri incelemek üzere openclaw tasks list veya openclaw tasks show <taskId> kullanın.
• Tamamlama uyandırması: OpenClaw, modelin kullanıcıya dönük takibi 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 çalışıyorsa küçük bir çalışma zamanı ipucu alır; böylece model körlemesine yeniden music_generate çağırmaz.
• Oturumsuz fallback: gerçek bir agent oturumu olmayan doğrudan/yerel bağlamlar yine satır içi çalışır ve nihai ses sonucunu aynı turda döndürür.

​

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

1. queued — görev oluşturuldu, sağlayıcının bunu kabul etmesi bekleniyor.
2. running — sağlayıcı işliyor (genellikle sağlayıcıya ve süreye bağlı olarak 30 saniye ile 3 dakika arası).
3. succeeded — parça hazır; agent uyanır ve bunu konuşmaya gönderir.
4. failed — sağlayıcı hatası veya zaman aşımı; agent hata ayrıntılarıyla uyanır.

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.5+"],
      },
    },
  },
}

​

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

1. Agent bir değer belirtirse araç çağrısından gelen model parametresi
2. Config’den gelen musicGenerationModel.primary
3. Sırayla musicGenerationModel.fallbacks
4. Yalnızca auth destekli sağlayıcı varsayılanlarını kullanarak otomatik algılama:
   • önce geçerli varsayılan sağlayıcı
   • ardından sağlayıcı kimliği sırasına göre kayıtlı kalan müzik üretimi sağlayıcıları

​

Sağlayıcı notları

• Google, Lyria 3 batch generation kullanır. Mevcut paketlenmiş akış; prompt, isteğe bağlı şarkı sözü metni ve isteğe bağlı referans görüntüleri destekler.
• MiniMax, batch music_generation uç noktasını kullanır. Mevcut paketlenmiş akış; prompt, isteğe bağlı şarkı sözleri, enstrümantal mod, süre yönlendirme ve mp3 çıktısını destekler.
• ComfyUI desteği workflow odaklıdır ve yapılandırılmış grafik ile prompt/çıktı alanları için düğüm eşlemesine bağlıdır.

​

Sağlayıcı yetenek modları

• yalnızca prompt ile üretim için generate
• istek bir veya daha fazla referans görüntü içerdiğinde edit

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

​

Doğru yolu seçme

• Model seçimi, sağlayıcı failover’ı ve yerleşik asenkron görev/durum akışını istiyorsanız paylaşılan sağlayıcı destekli yolu kullanın.
• Özel bir workflow grafiğine veya paylaşılan paketlenmiş müzik yeteneğinin parçası olmayan bir sağlayıcıya ihtiyacınız varsa ComfyUI gibi bir plugin yolunu kullanın.
• ComfyUI’ya özgü davranışı hata ayıklıyorsanız ComfyUI ile başlayın. Paylaşılan sağlayıcı davranışını hata ayıklıyorsanız Google (Gemini) veya MiniMax ile başlayın.

​

Canlı testler

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

pnpm test:live:media music

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

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

​

İlgili

• Arka Plan Görevleri - ayrık music_generate çalıştırmaları için görev izleme
• Configuration Reference - musicGenerationModel config’i
• ComfyUI
• Google (Gemini)
• MiniMax
• Models - model yapılandırması ve failover
• Tools Overview