Generazione musicale

​

Avvio rapido

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

/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

​

Provider supportati

​

Matrice delle funzionalità

​

Parametri dello strumento

​

Comportamento asincrono

• Attività in background: music_generate crea un’attività in background, restituisce immediatamente una risposta di avvio/attività e pubblica successivamente la traccia completata in un messaggio di follow-up dell’agente.
• Prevenzione dei duplicati: mentre un’attività è queued o running, le successive chiamate a music_generate nella stessa sessione restituiscono lo stato dell’attività invece di avviare un’altra generazione. Usa action: "status" per eseguire un controllo esplicito. Anche una richiesta corrispondente completata di recente viene deduplicata per 2 minuti.
• Consultazione dello stato: openclaw tasks list o openclaw tasks show <taskId> esamina gli stati in coda, in esecuzione e terminali.
• Riattivazione al completamento: OpenClaw inserisce nuovamente un evento interno di completamento nella stessa sessione, affinché il modello possa scrivere autonomamente il follow-up rivolto all’utente.
• Indicazione nel prompt: i successivi turni utente/manuali nella stessa sessione ricevono una breve indicazione di runtime quando è già in corso un’attività musicale, affinché il modello non chiami nuovamente music_generate senza verificarlo.
• Fallback senza sessione: i contesti diretti/locali senza una vera sessione dell’agente vengono eseguiti in linea e restituiscono il risultato audio finale nello stesso turno.

​

Ciclo di vita dell’attività

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

​

Configurazione

​

Selezione del modello

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

​

Ordine di selezione dei provider

1. Parametro model della chiamata allo strumento (se l’agente ne specifica uno).
2. musicGenerationModel.primary dalla configurazione.
3. musicGenerationModel.fallbacks nell’ordine indicato.
4. Rilevamento automatico usando esclusivamente i valori predefiniti dei provider con autenticazione configurata:
   • prima il provider predefinito corrente del modello testuale, se offre anche la generazione musicale;
   • quindi i restanti provider di generazione musicale registrati, in ordine alfabetico per ID provider.

​

Note sui provider

​

Scelta del percorso corretto

• Basato su provider condivisi quando desideri la selezione del modello, il failover dei provider e il flusso asincrono integrato per attività e stato.
• Percorso Plugin (ComfyUI) quando hai bisogno di un grafo del flusso di lavoro personalizzato o di un provider che non fa parte della funzionalità musicale condivisa inclusa.

​

Modalità delle funzionalità dei provider

• generate per la generazione basata solo su prompt.
• edit quando la richiesta include una o più immagini di riferimento.

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

​

Test live

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

pnpm test:live:media:music

• google: generate più edit
• fal: solo generate
• minimax: solo generate
• openrouter: generate più edit
• comfy: copertura live Comfy separata, non inclusa nella verifica condivisa dei provider

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

​

Contenuti correlati

• Attività in background — monitoraggio delle attività per le esecuzioni scollegate di music_generate
• ComfyUI
• Riferimento per la configurazione — configurazione musicGenerationModel
• Google (Gemini)
• MiniMax
• Modelli — configurazione e failover dei modelli
• Panoramica degli strumenti