Generowanie muzyki w OpenClaw (music_generate)

Wprowadzenie

Narzedzie music_generate umozliwia agentom tworzenie muzyki i audio za posrednictwem skonfigurowanych dostawcow — Google, MiniMax i ComfyUI. W sesjach opartych na agentach generowanie odbywa sie jako zadanie w tle, a agent otrzymuje powiadomienie, gdy utwor jest gotowy.

Dostepnosc

Narzedzie pojawia sie tylko wtedy, gdy skonfigurowany jest co najmniej jeden dostawca generowania muzyki. Nalezy ustawic agents.defaults.musicGenerationModel lub skonfigurowac klucz API dostawcy.

Obslugiwani dostawcy

• Google (lyria-3-clip-preview) — obsluguje do 10 obrazow referencyjnych, teksty piosenek, tryb instrumentalny, format wyjsciowy. Klucze: GEMINI_API_KEY, GOOGLE_API_KEY
• MiniMax (music-2.5+) — obsluguje teksty piosenek, tryb instrumentalny, czas trwania, format MP3. Klucz: MINIMAX_API_KEY
• ComfyUI (workflow) — do 1 obrazu referencyjnego, konfiguracja przez workflow. Klucze: COMFY_API_KEY, COMFY_CLOUD_API_KEY

Parametry narzedzia

• prompt — opis generowanej muzyki (wymagany dla akcji generate)
• action — generate (domyslny), status lub list
• model — nadpisanie dostawcy/modelu (np. google/lyria-3-pro-preview)
• lyrics — opcjonalne teksty piosenek
• instrumental — zadanie wylacznie instrumentalnego utworu
• image / images — obrazy referencyjne (do 10)
• durationSeconds — wskazowka dotyczaca czasu trwania
• format — format wyjsciowy (mp3 lub wav)
• filename — wskazowka dotyczaca nazwy pliku wyjsciowego

Zachowanie asynchroniczne

Generowanie muzyki przebiega jako zadanie w tle z natychmiastowa odpowiedzia:

• Zapobieganie duplikatom — aktywne zadania blokuja jednoczesne nowe zadania
• Sprawdzanie statusu — uzyj action: "status" do sprawdzenia stanu bez inicjowania generowania
• Sledzenie zadan — polecenia CLI: openclaw tasks list/show/cancel <taskId>

Cykl zycia zadania

1. queued — zadanie utworzone, oczekuje na akceptacje dostawcy
2. running — dostawca przetwarza (zazwyczaj 30 sekund do 3 minut)
3. succeeded — utwor gotowy; agent publikuje go w konwersacji
4. failed — blad dostawcy lub przekroczenie limitu czasu

Konfiguracja

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "google/lyria-3-clip-preview",
        fallbacks: ["minimax/music-2.5+"],
      },
    },
  },
}