Generación de música

​

Inicio rápido

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

/tool music_generate prompt="Bucle cálido de sintetizador ambiental con una suave textura de cinta"

Genera una pista cinematográfica de piano con cuerdas suaves y sin voces.

Genera un bucle chiptune enérgico sobre el lanzamiento de un cohete al amanecer.

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

/tool music_generate prompt="Hip hop lo-fi de ensueño con textura de vinilo y lluvia suave" 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 inmediatamente una respuesta de inicio/tarea y publica posteriormente la pista terminada 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. Use action: "status" para comprobarlo explícitamente. Una solicitud coincidente completada recientemente también se desduplica durante 2 minutos.
• Consulta de estado: openclaw tasks list o openclaw tasks show <taskId> consulta los estados en cola, en ejecución y terminales.
• Reactivación al finalizar: OpenClaw vuelve a inyectar un evento interno de finalización en la misma sesión para que el propio modelo pueda redactar el seguimiento dirigido al usuario.
• Indicación de la solicitud: los turnos posteriores del usuario o manuales de la misma sesión reciben una pequeña indicación en tiempo de ejecución cuando ya hay una tarea de música 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 del agente se ejecutan en línea y devuelven el resultado final del audio en el mismo turno.

​

Ciclo de vida de las tareas

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

​

Configuración

​

Selección del 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 proveedores

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

​

Notas sobre los proveedores

​

Elección de la ruta adecuada

• Con respaldo de proveedor compartido cuando se requiera selección de modelos, conmutación por error entre proveedores y el flujo asíncrono integrado de tareas y estados.
• Ruta del Plugin (ComfyUI) cuando se necesite un grafo de flujo de trabajo personalizado o un proveedor que no forme parte de la capacidad compartida incluida de generación de música.

​

Modos de capacidad de proveedores

• generate para la generación basada únicamente en indicaciones.
• 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 independiente, no incluida en el barrido de proveedores compartidos

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

​

Temas relacionados

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