Muziekgeneratie

​

Snel aan de slag

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

/tool music_generate prompt="Warme ambient-synthloop met een zachte bandtextuur"

Genereer een filmische pianotrack met zachte strijkers en zonder zang.

Genereer een energieke chiptuneloop over het lanceren van een raket bij zonsopgang.

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

/tool music_generate prompt="Dromerige lo-fi-hiphop met vinyltextuur en zachte regen" instrumental=true

​

Ondersteunde providers

​

Mogelijkhedenmatrix

​

Toolparameters

​

Asynchroon gedrag

• Achtergrondtaak: music_generate maakt een achtergrondtaak, retourneert onmiddellijk een gestart-/taakantwoord en plaatst de voltooide track later in een vervolgbericht van de agent.
• Dubbel werk voorkomen: zolang een taak queued of running is, retourneren latere aanroepen van music_generate in dezelfde sessie de taakstatus in plaats van een nieuwe generatie te starten. Gebruik action: "status" om dit expliciet te controleren. Een recent voltooid, overeenkomend verzoek wordt ook gedurende 2 minuten gededupliceerd.
• Status opzoeken: openclaw tasks list of openclaw tasks show <taskId> bekijkt de status in de wachtrij, tijdens uitvoering en na beëindiging.
• Wekken bij voltooiing: OpenClaw injecteert een interne voltooiingsgebeurtenis terug in dezelfde sessie, zodat het model zelf het gebruikersgerichte vervolgbericht kan schrijven.
• Promptaanwijzing: latere gebruikers-/handmatige beurten in dezelfde sessie krijgen een kleine runtime-aanwijzing wanneer een muziektaak al wordt uitgevoerd, zodat het model music_generate niet blind opnieuw aanroept.
• Fallback zonder sessie: directe/lokale contexten zonder een echte agentsessie worden inline uitgevoerd en retourneren het definitieve audioresultaat in dezelfde beurt.

​

Levenscyclus van taken

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

​

Configuratie

​

Modelselectie

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

​

Selectievolgorde van providers

1. model-parameter uit de toolaanroep (als de agent er een opgeeft).
2. musicGenerationModel.primary uit de configuratie.
3. musicGenerationModel.fallbacks in volgorde.
4. Automatische detectie, uitsluitend met standaardproviders op basis van authenticatie:
   • eerst de huidige standaardprovider voor tekstmodellen, als deze ook muziekgeneratie aanbiedt;
   • de overige geregistreerde providers voor muziekgeneratie, alfabetisch op provider-id.

​

Opmerkingen over providers

​

Het juiste pad kiezen

• Gedeeld, ondersteund door providers wanneer je modelselectie, provider- failover en de ingebouwde asynchrone taak-/statusflow wilt.
• Pluginpad (ComfyUI) wanneer je een aangepaste workflowgraaf nodig hebt of een provider die geen deel uitmaakt van de gedeelde meegeleverde muziekfunctionaliteit.

​

Providerfunctionaliteitsmodi

• generate voor generatie op basis van 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,
  },
}

​

Livetests

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

pnpm test:live:media:music

• google: generate plus edit
• fal: alleen generate
• minimax: alleen generate
• openrouter: generate plus edit
• comfy: afzonderlijke Comfy-livetestdekking, geen onderdeel van de gedeelde providerreeks

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

​

Gerelateerd

• Achtergrondtaken — taakregistratie voor losgekoppelde music_generate-uitvoeringen
• ComfyUI
• Configuratiereferentie — musicGenerationModel-configuratie
• Google (Gemini)
• MiniMax
• Modellen — modelconfiguratie en failover
• Overzicht van tools