Muziekgeneratie

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.

​

Snel starten

{
  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

​

Hulpprogrammaparameters

​

Asynchroon gedrag

• Achtergrondtaak: music_generate maakt een achtergrondtaak, retourneert onmiddellijk een gestart-/taakrespons en post het voltooide nummer later in een opvolgend agentbericht.
• Dubbele aanroepen voorkomen: terwijl een taak queued of running is, retourneren latere music_generate-aanroepen in dezelfde sessie de 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-, lopende en terminale status.
• Voltooiingswake: OpenClaw injecteert een interne voltooiingsgebeurtenis terug in dezelfde sessie, zodat het model zelf de gebruikersgerichte follow-up 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 worden inline uitgevoerd 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"],
      },
    },
  },
}

​

Volgorde voor providerselectie

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

​

Providernotities

​

Het juiste pad kiezen

• Gedeeld en provider-ondersteund wanneer je modelselectie, providerfailover en de ingebouwde asynchrone taak-/statusflow wilt.
• Plugin-pad (ComfyUI) wanneer je een aangepaste workflowgraph nodig hebt of een provider die geen onderdeel is van de gedeelde meegeleverde muziekmogelijkheid.

​

Providermodi voor mogelijkheden

• generate voor prompt-only generatie.
• edit wanneer de aanvraag één 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-livedekking, 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
• Overzicht van tools