Müzik üretimi

​

Hızlı başlangıç

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

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

Yumuşak yaylılar içeren ve vokal içermeyen sinematik bir piyano parçası oluştur.

Gün doğumunda bir roket fırlatma hakkında enerjik bir chiptune döngüsü oluştur.

/tool music_generate action=list
/tool music_generate action=status

/tool music_generate prompt="Plak dokusu ve hafif yağmur içeren rüya gibi lo-fi hip hop" instrumental=true

​

Desteklenen sağlayıcılar

​

Yetenek matrisi

​

Araç parametreleri

​

Eşzamansız davranış

• 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ü

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: ["fal/fal-ai/minimax-music/v2.6", "minimax/music-2.6"],
      },
    },
  },
}

​

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

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.

​

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.

​

Sağlayıcı yetenek modları

• Yalnızca istemle oluşturma için generate.
• İstek bir veya daha fazla referans görseli içerdiğinde edit.

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

​

Canlı testler

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

pnpm test:live:media:music

• 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ı

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

​

İ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ış