Muziekgeneratie

Documentation Index

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

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

​

Snel aan de slag

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

​

Ondersteunde providers

​

Mogelijkhedenmatrix

/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

​

Hulpmiddelparameters

​

Asynchroon gedrag

• Achtergrondtaak: music_generate maakt een achtergrondtaak aan, retourneert onmiddellijk een gestart-/taakantwoord en plaatst de voltooide track later in een vervolgbericht van de agent.
• Voorkoming van duplicaten: terwijl een taak queued of running is, retourneren latere music_generate-aanroepen in dezelfde sessie taakstatus in plaats van een nieuwe generatie te starten. Gebruik action: "status" om dit expliciet te controleren.
• Status opzoeken: openclaw tasks list of openclaw tasks show <taskId> inspecteert wachtrij-, actieve en terminale status.
• Voltooiingswake: OpenClaw injecteert een interne voltooiingsgebeurtenis terug in dezelfde sessie, zodat het model zelf de gebruikersgerichte opvolging kan schrijven.
• Prompthint: latere gebruikers-/handmatige beurten in dezelfde sessie krijgen een kleine runtimehint wanneer er al een muziektaak loopt, zodat het model niet blind opnieuw music_generate aanroept.
• Fallback zonder sessie: directe/lokale contexten zonder echte agentsessie voeren inline uit en retourneren het uiteindelijke audioresultaat in dezelfde beurt.

​

Taaklevenscyclus

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

​

Configuratie

​

Modelselectie

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

​

Selectievolgorde van providers

1. model-parameter uit de hulpmiddelaanroep (als de agent er een opgeeft).
2. musicGenerationModel.primary uit de configuratie.
3. musicGenerationModel.fallbacks op volgorde.
4. Automatische detectie met alleen op authenticatie gebaseerde providerstandaarden:
   • huidige standaardprovider eerst;
   • resterende geregistreerde muziekgeneratieproviders op volgorde van provider-id.

​

Provideropmerkingen

​

Het juiste pad kiezen

• Met gedeelde provider wanneer je modelselectie, providerfailover en de ingebouwde asynchrone taak-/statusflow wilt.
• Plugin-pad (ComfyUI) wanneer je een aangepaste workflowgrafiek nodig hebt of een provider die geen deel uitmaakt van de gedeelde gebundelde muziekmogelijkheid.

​

Providermogelijkheidsmodi

• generate voor generatie met alleen een prompt.
• edit wanneer het verzoek een of meer referentieafbeeldingen bevat.

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

​

Live tests

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

pnpm test:live:media music

• google: generate plus edit
• minimax: alleen generate
• comfy: afzonderlijke Comfy-live-dekking, niet de gedeelde providersweep

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

​

Gerelateerd

• Achtergrondtaken — taaktracking voor losgekoppelde music_generate-runs
• ComfyUI
• Configuratiereferentie — musicGenerationModel-configuratie
• Google (Gemini)
• MiniMax
• Modellen — modelconfiguratie en failover
• Toolsoverzicht