Generación de música

​

Inicio rápido

{
  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

​

Proveedores compatibles

​

Matriz de capacidades

​

Parámetros de la herramienta

​

Comportamiento asíncrono

• Tarea en segundo plano: music_generate crea una tarea en segundo plano, devuelve de inmediato una respuesta de inicio/tarea y publica la pista terminada más tarde en un mensaje de seguimiento del agente.
• Prevención de duplicados: mientras una tarea está en queued o running, las llamadas posteriores a music_generate en la misma sesión devuelven el estado de la tarea en lugar de iniciar otra generación. Usa action: "status" para comprobarlo explícitamente. Una solicitud coincidente completada recientemente también se desduplica durante 2 minutos.
• Consulta de estado: openclaw tasks list u openclaw tasks show <taskId> inspecciona estados en cola, en ejecución y terminales.
• Activación al completar: OpenClaw inyecta un evento interno de finalización de vuelta en la misma sesión para que el modelo pueda escribir por sí mismo el seguimiento visible para el usuario.
• Indicación de prompt: los turnos posteriores de usuario/manuales en la misma sesión reciben una pequeña indicación de runtime cuando una tarea de música ya está en curso, para que el modelo no vuelva a llamar a music_generate a ciegas.
• Alternativa sin sesión: los contextos directos/locales sin una sesión real de agente se ejecutan en línea y devuelven el resultado final de audio en el mismo turno.

​

Ciclo de vida de la tarea

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

​

Configuración

​

Selección de modelo

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

​

Orden de selección de proveedor

1. Parámetro model de la llamada a la herramienta (si el agente especifica uno).
2. musicGenerationModel.primary desde la configuración.
3. musicGenerationModel.fallbacks en orden.
4. Detección automática usando solo valores predeterminados de proveedores respaldados por autenticación:
   • primero el proveedor de modelo de texto predeterminado actual, si también ofrece generación de música;
   • los proveedores de generación de música registrados restantes, alfabéticamente por id. de proveedor.

​

Notas de proveedores

​

Elegir la ruta correcta

• Respaldado por proveedor compartido cuando quieres selección de modelos, conmutación por error de proveedores y el flujo asíncrono integrado de tareas/estado.
• Ruta de Plugin (ComfyUI) cuando necesitas un grafo de flujo de trabajo personalizado o un proveedor que no forma parte de la capacidad musical compartida incluida.

​

Modos de capacidad de proveedor

• generate para generación solo con prompt.
• edit cuando la solicitud incluye una o más imágenes de referencia.

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

​

Pruebas en vivo

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

pnpm test:live:media:music

• google: generate más edit
• fal: solo generate
• minimax: solo generate
• openrouter: generate más edit
• comfy: cobertura en vivo de Comfy separada, no el barrido de proveedores compartidos

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

​

Relacionado

• Tareas en segundo plano — seguimiento de tareas para ejecuciones desacopladas de music_generate
• ComfyUI
• Referencia de configuración — configuración de musicGenerationModel
• Google (Gemini)
• MiniMax
• Modelos — configuración de modelos y conmutación por error
• Resumen de herramientas