Generowanie muzyki

​

Szybki start

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

/tool music_generate prompt="Ciepła ambientowa pętla syntezatorowa z delikatną fakturą taśmy"

Wygeneruj filmowy utwór fortepianowy z delikatnymi smyczkami i bez wokalu.

Wygeneruj energiczną pętlę chiptune o wystrzeleniu rakiety o wschodzie słońca.

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

/tool music_generate prompt="Marzycielski lo-fi hip-hop z fakturą winylu i łagodnym deszczem" instrumental=true

​

Obsługiwani dostawcy

​

Macierz możliwości

​

Parametry narzędzia

​

Działanie asynchroniczne

• Zadanie w tle: music_generate tworzy zadanie w tle, natychmiast zwraca odpowiedź o rozpoczęciu wraz z informacjami o zadaniu, a później publikuje gotowy utwór w kolejnej wiadomości agenta.
• Zapobieganie duplikatom: gdy zadanie ma stan queued lub running, kolejne wywołania music_generate w tej samej sesji zwracają stan zadania zamiast rozpoczynać następne generowanie. Użyj action: "status", aby sprawdzić go jawnie. Niedawno ukończone pasujące żądanie jest również deduplikowane przez 2 minuty.
• Sprawdzanie stanu: openclaw tasks list lub openclaw tasks show <taskId> pozwala sprawdzić stan oczekujący, aktywny i końcowy.
• Wybudzenie po zakończeniu: OpenClaw wprowadza wewnętrzne zdarzenie zakończenia z powrotem do tej samej sesji, aby model mógł samodzielnie napisać dalszą odpowiedź przeznaczoną dla użytkownika.
• Wskazówka w monicie: kolejne tury użytkownika lub ręczne w tej samej sesji otrzymują krótką wskazówkę środowiska wykonawczego, gdy zadanie muzyczne jest już w toku, dzięki czemu model nie wywołuje ponownie music_generate bez sprawdzenia.
• Tryb awaryjny bez sesji: konteksty bezpośrednie/lokalne bez rzeczywistej sesji agenta działają synchronicznie i zwracają końcowy wynik dźwiękowy w tej samej turze.

​

Cykl życia zadania

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

​

Konfiguracja

​

Wybór modelu

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "google/lyria-3-clip-preview",
        fallbacks: ["fal/fal-ai/minimax-music/v2.6", "minimax/music-2.6"],
      },
    },
  },
}

​

Kolejność wyboru dostawcy

1. Parametr model z wywołania narzędzia (jeśli agent go określi).
2. musicGenerationModel.primary z konfiguracji.
3. Wpisy musicGenerationModel.fallbacks w podanej kolejności.
4. Automatyczne wykrywanie wyłącznie na podstawie domyślnych dostawców z uwierzytelnianiem:
   • najpierw bieżący domyślny dostawca modelu tekstowego, jeśli oferuje również generowanie muzyki;
   • pozostali zarejestrowani dostawcy generowania muzyki, alfabetycznie według identyfikatora dostawcy.

​

Uwagi dotyczące dostawców

​

Wybór właściwej ścieżki

• Współdzielona ścieżka oparta na dostawcy, gdy potrzebujesz wyboru modelu, przełączania awaryjnego między dostawcami i wbudowanego asynchronicznego przepływu zadań i statusów.
• Ścieżka pluginu (ComfyUI), gdy potrzebujesz niestandardowego grafu przepływu pracy lub dostawcy, który nie jest częścią współdzielonej, dołączonej funkcji muzycznej.

​

Tryby możliwości dostawcy

• generate do generowania wyłącznie na podstawie polecenia.
• edit, gdy żądanie zawiera co najmniej jeden obraz referencyjny.

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

​

Testy na żywo

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

pnpm test:live:media:music

• google: generate oraz edit
• fal: tylko generate
• minimax: tylko generate
• openrouter: generate oraz edit
• comfy: oddzielne testy Comfy na żywo, poza współdzielonym zestawem testów dostawców

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

​

Powiązane

• Zadania w tle — śledzenie zadań dla odłączonych uruchomień music_generate
• ComfyUI
• Dokumentacja konfiguracji — konfiguracja musicGenerationModel
• Google (Gemini)
• MiniMax
• Modele — konfiguracja modeli i przełączanie awaryjne
• Przegląd narzędzi