Musikgenerierung

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.

​

Schnellstart

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

​

Unterstützte Provider

​

Funktionsmatrix

/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

​

Tool-Parameter

​

Asynchrones Verhalten

• Hintergrundaufgabe: music_generate erstellt eine Hintergrundaufgabe, gibt sofort eine Started-/Task-Antwort zurück und postet den fertigen Track später in einer nachfolgenden Agentennachricht.
• Duplikatvermeidung: Solange eine Aufgabe queued oder running ist, geben spätere music_generate-Aufrufe in derselben Sitzung den Aufgabenstatus zurück, statt eine weitere Generierung zu starten. Verwenden Sie action: "status" für eine explizite Prüfung.
• Statusabfrage: openclaw tasks list oder openclaw tasks show <taskId> prüft wartende, laufende und terminale Status.
• Completion-Wake: OpenClaw injiziert ein internes Completion-Ereignis zurück in dieselbe Sitzung, damit das Modell selbst die für Benutzer sichtbare Folgenachricht schreiben kann.
• Prompt-Hinweis: Spätere Benutzer-/manuelle Turns in derselben Sitzung erhalten einen kleinen Laufzeithinweis, wenn bereits eine Musikaufgabe läuft, damit das Modell music_generate nicht blind erneut aufruft.
• Fallback ohne Sitzung: Direkte/lokale Kontexte ohne echte Agentensitzung laufen inline und geben das finale Audioergebnis im selben Turn zurück.

​

Aufgabenlebenszyklus

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

​

Konfiguration

​

Modellauswahl

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

​

Reihenfolge der Providerauswahl

1. model-Parameter aus dem Tool-Aufruf (wenn der Agent einen angibt).
2. musicGenerationModel.primary aus der Konfiguration.
3. musicGenerationModel.fallbacks der Reihe nach.
4. Automatische Erkennung nur mit authentifizierungsgestützten Provider-Standards:
   • aktueller Standard-Provider zuerst;
   • übrige registrierte Musikgenerierungs-Provider in Provider-ID-Reihenfolge.

​

Provider-Hinweise

​

Den richtigen Pfad wählen

• Geteilter Provider-gestützt, wenn Sie Modellauswahl, Provider-Failover und den integrierten asynchronen Task-/Statusablauf möchten.
• Plugin-Pfad (ComfyUI), wenn Sie einen benutzerdefinierten Workflow-Graphen oder einen Provider benötigen, der nicht Teil der geteilten gebündelten Musikfunktion ist.

​

Provider-Funktionsmodi

• generate für reine Prompt-Generierung.
• edit, wenn die Anfrage ein oder mehrere Referenzbilder enthält.

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: nur generate
• comfy: separate Comfy-Live-Abdeckung, nicht der gemeinsame Provider-Sweep

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

​

Verwandt

• Hintergrundaufgaben — Aufgabenverfolgung für abgetrennte music_generate-Ausführungen
• ComfyUI
• Konfigurationsreferenz — musicGenerationModel-Konfiguration
• Google (Gemini)
• MiniMax
• Modelle — Modellkonfiguration und Failover
• Tools-Übersicht