Generowanie muzyki

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.

​

Szybki start

{
  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.

​

Obsługiwani dostawcy

​

Macierz funkcji

/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

​

Parametry narzędzia

​

Zachowanie asynchroniczne

• Zadanie w tle: music_generate tworzy zadanie w tle, od razu zwraca odpowiedź uruchomione/zadanie i później publikuje gotowy utwór w kolejnej wiadomości agenta.
• Zapobieganie duplikatom: gdy zadanie ma stan queued lub running, późniejsze wywołania music_generate w tej samej sesji zwracają status zadania zamiast uruchamiać kolejne generowanie. Użyj action: "status", aby sprawdzić to jawnie.
• Wyszukiwanie statusu: openclaw tasks list lub openclaw tasks show <taskId> sprawdza statusy w kolejce, uruchomione i końcowe.
• Wybudzenie po ukończeniu: OpenClaw wstrzykuje wewnętrzne zdarzenie ukończenia z powrotem do tej samej sesji, aby model mógł sam napisać dalszą wiadomość widoczną dla użytkownika.
• Wskazówka promptu: późniejsze tury użytkownika/ręczne w tej samej sesji dostają małą wskazówkę runtime, gdy zadanie muzyczne jest już w toku, aby model nie wywoływał bezrefleksyjnie music_generate ponownie.
• Awaryjnie bez sesji: bezpośrednie/lokalne konteksty bez rzeczywistej sesji agenta działają inline i zwracają końcowy wynik audio 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: ["minimax/music-2.6"],
      },
    },
  },
}

​

Kolejność wyboru dostawców

1. Parametr model z wywołania narzędzia (jeśli agent go określi).
2. musicGenerationModel.primary z konfiguracji.
3. musicGenerationModel.fallbacks w kolejności.
4. Automatyczne wykrywanie używające tylko domyślnych dostawców opartych na uwierzytelnianiu:
   • najpierw bieżący dostawca domyślny;
   • pozostali zarejestrowani dostawcy generowania muzyki w kolejności identyfikatorów dostawców.

​

Uwagi o dostawcach

​

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

• Oparta na współdzielonym dostawcy, gdy chcesz wyboru modelu, przełączania awaryjnego dostawców oraz wbudowanego asynchronicznego przepływu zadań/statusu.
• Ścieżka pluginu (ComfyUI), gdy potrzebujesz niestandardowego grafu workflow lub dostawcy, który nie jest częścią współdzielonej dołączonej funkcji muzyki.

​

Tryby funkcji dostawcy

• generate dla generowania wyłącznie z promptu.
• edit, gdy żądanie zawiera jeden lub więcej obrazów referencyjnych.

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

​

Testy live

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

pnpm test:live:media music

• google: generate oraz edit
• minimax: tylko generate
• comfy: oddzielne pokrycie Comfy na żywo, nie współdzielony przegląd 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