Musikgenerierung

​

Schnellstart

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

/tool music_generate prompt="Warme Ambient-Synthesizer-Schleife mit weicher Tonbandtextur"

Erstellen Sie einen cineastischen Klaviertitel mit sanften Streichern und ohne Gesang.

Erstellen Sie eine energiegeladene Chiptune-Schleife über den Start einer Rakete bei Sonnenaufgang.

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

/tool music_generate prompt="Verträumter Lo-Fi-Hip-Hop mit Vinyltextur und sanftem Regen" instrumental=true

​

Unterstützte Provider

​

Funktionsmatrix

​

Tool-Parameter

​

Asynchrones Verhalten

• Hintergrundaufgabe: music_generate erstellt eine Hintergrundaufgabe, gibt sofort eine Antwort mit Start-/Aufgabeninformationen zurück und veröffentlicht den fertigen Titel später in einer nachfolgenden Agent-Nachricht.
• Vermeidung von Duplikaten: Solange eine Aufgabe queued oder running ist, geben spätere music_generate-Aufrufe in derselben Sitzung den Aufgabenstatus zurück, anstatt eine weitere Generierung zu starten. Verwenden Sie action: "status", um dies ausdrücklich zu prüfen. Eine kürzlich abgeschlossene, übereinstimmende Anfrage wird ebenfalls 2 Minuten lang dedupliziert.
• Statusabfrage: openclaw tasks list oder openclaw tasks show <taskId> prüft den Status von Aufgaben in der Warteschlange, in Ausführung und mit Endstatus.
• Aktivierung bei Abschluss: OpenClaw fügt ein internes Abschlussereignis wieder in dieselbe Sitzung ein, damit das Modell selbst die benutzerseitige Folgemeldung verfassen kann.
• Prompt-Hinweis: Spätere Benutzer-/manuelle Durchläufe in derselben Sitzung erhalten einen kurzen Laufzeithinweis, wenn bereits eine Musikaufgabe läuft, damit das Modell music_generate nicht unbedacht erneut aufruft.
• Fallback ohne Sitzung: Direkte/lokale Kontexte ohne echte Agent- Sitzung werden direkt ausgeführt und geben das endgültige Audioergebnis im selben Durchlauf 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: ["fal/fal-ai/minimax-music/v2.6", "minimax/music-2.6"],
      },
    },
  },
}

​

Reihenfolge der Provider-Auswahl

1. model-Parameter aus dem Tool-Aufruf (falls der Agent einen angibt).
2. musicGenerationModel.primary aus der Konfiguration.
3. musicGenerationModel.fallbacks der Reihe nach.
4. Automatische Erkennung ausschließlich anhand authentifizierungsgestützter Provider-Standardwerte:
   • zuerst der aktuelle Standard-Provider für Textmodelle, sofern er auch Musikgenerierung anbietet;
   • die übrigen registrierten Provider für Musikgenerierung, alphabetisch nach Provider-ID.

​

Hinweise zu Providern

​

Den richtigen Pfad wählen

• Gemeinsamer Provider-gestützter Pfad, wenn Sie Modellauswahl, Provider- Failover und den integrierten asynchronen Aufgaben-/Statusablauf benötigen.
• Plugin-Pfad (ComfyUI), wenn Sie einen benutzerdefinierten Workflow-Graphen oder einen Provider benötigen, der nicht zur gemeinsamen gebündelten Musikfunktion gehört.

​

Funktionsmodi der Provider

• generate für die Generierung nur aus Eingabeaufforderungen.
• 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
• fal: nur generate
• minimax: nur generate
• openrouter: generate plus edit
• comfy: separate Comfy-Live-Testabdeckung, nicht Teil des gemeinsamen Provider-Durchlaufs

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

​

Verwandte Themen

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