Müzik üretimi

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Hızlı başlangıç

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

/tool music_generate prompt="Warm ambient synth loop with soft tape texture"

Generate a cinematic piano track with soft strings and no vocals.

Generate an energetic chiptune loop about launching a rocket at sunrise.

​

Desteklenen sağlayıcılar

​

Yetenek matrisi

/tool music_generate action=list

/tool music_generate action=status

/tool music_generate prompt="Dreamy lo-fi hip hop with vinyl texture and gentle rain" instrumental=true

​

Araç parametreleri

​

Zaman uyumsuz 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 takip eden bir ajan mesajında gönderir.
• Yinelenmeyi ö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 araması: openclaw tasks list veya openclaw tasks show <taskId> kuyruğa alınmış, çalışan ve terminal durumları inceler.
• Tamamlama uyandırması: OpenClaw, modelin kullanıcıya yönelik takip yanıtını kendisinin yazabilmesi için aynı oturuma dahili bir tamamlama olayı enjekte eder.
• İstem ipucu: aynı oturumdaki sonraki kullanıcı/manuel dönüşler, bir müzik görevi zaten sürüyorsa küçük bir çalışma zamanı ipucu alır; böylece model körlemesine yeniden music_generate çağırmaz.
• Oturumsuz geri dönüş: gerçek ajan oturumu olmayan doğrudan/yerel bağlamlar satır içi çalışır ve final ses sonucunu aynı dönüşte 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: ["minimax/music-2.6"],
      },
    },
  },
}

​

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

1. Araç çağrısından gelen 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ını kullanarak otomatik algılama:
   • önce geçerli varsayılan sağlayıcı;
   • kalan kayıtlı müzik üretimi sağlayıcıları, sağlayıcı kimliği sırasına göre.

​

Sağlayıcı notları

​

Doğru yolu seçme

• Paylaşılan sağlayıcı destekli, model seçimi, sağlayıcı devretmesi ve yerleşik zaman uyumsuz görev/durum akışı istediğinizde.
• Plugin yolu (ComfyUI), özel bir iş akışı grafiğine veya paylaşılan paketlenmiş müzik yeteneğinin parçası olmayan bir sağlayıcıya ihtiyaç duyduğunuzda.

​

Sağlayıcı yetenek modları

• Yalnızca istemle üretim için generate.
• İstek bir veya daha fazla referans görsel 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
• minimax: yalnızca generate
• comfy: paylaşılan sağlayıcı taraması değil, 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 takibi
• ComfyUI
• Yapılandırma başvurusu — musicGenerationModel yapılandırması
• Google (Gemini)
• MiniMax
• Modeller — model yapılandırması ve yük devretme
• Araçlara genel bakış