Videogenerierung

• generate - Text-zu-Video-Anfragen ohne Referenzmedien.
• imageToVideo - die Anfrage enthält ein oder mehrere Referenzbilder.
• videoToVideo - die Anfrage enthält ein oder mehrere Referenzvideos.

​

Schnellstart

export GEMINI_API_KEY="your-key"

openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1-fast-generate-preview"

​

So funktioniert asynchrone Generierung

1. OpenClaw übermittelt die Anfrage an den Provider und gibt sofort eine Aufgaben-ID zurück.
2. Der Provider verarbeitet den Auftrag im Hintergrund (typischerweise 30 Sekunden bis mehrere Minuten, je nach Provider und Auflösung; langsame queue-gestützte Provider können bis zum konfigurierten Timeout laufen).
3. Wenn das Video bereit ist, weckt OpenClaw dieselbe Sitzung mit einem internen Abschlussereignis.
4. Der Agent informiert den Benutzer über den normalen sichtbaren Antwortmodus der Sitzung: endgültige Antwortzustellung, wenn automatisch, oder message(action="send"), wenn die Sitzung das Nachrichtentool erfordert. Wenn die anfragende Sitzung inaktiv ist oder ihr aktives Wecken fehlschlägt und in der Abschlussantwort noch generiertes Video fehlt, sendet OpenClaw einen idempotenten direkten Fallback nur mit dem fehlenden Video.

​

Aufgabenlebenszyklus

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

​

Unterstützte Provider

​

Capability-Matrix

​

Tool-Parameter

​

Erforderlich

​

Inhaltseingaben

​

Stilsteuerungen

​

Erweitert

• Keine Referenzmedien → generate
• Beliebige Bildreferenz → imageToVideo
• Beliebige Videoreferenz → videoToVideo
• Referenz-Audioeingaben ändern den aufgelösten Modus nicht; sie werden auf den Modus angewendet, den die Bild-/Videoreferenzen auswählen, und funktionieren nur mit Providern, die maxInputAudios deklarieren.

​

Fallback und typisierte Optionen

• Aktiver Kandidat, der kein maxInputAudios (oder 0) deklariert, wird übersprungen, wenn die Anfrage Audioreferenzen enthält; der nächste Kandidat wird versucht.
• maxDurationSeconds des aktiven Kandidaten liegt unter dem angeforderten durationSeconds und es ist keine Liste supportedDurationSeconds deklariert → übersprungen.
• Anfrage enthält providerOptions und der aktive Kandidat deklariert explizit ein typisiertes providerOptions-Schema → übersprungen, wenn gelieferte Schlüssel nicht im Schema enthalten sind oder Werttypen nicht übereinstimmen. Provider ohne deklariertes Schema erhalten Optionen unverändert (rückwärtskompatible Durchreichung). Ein Provider kann alle Provider-Optionen ablehnen, indem er ein leeres Schema deklariert (capabilities.providerOptions: {}), was denselben Skip wie eine Typabweichung verursacht.

​

Aktionen

​

Modellauswahl

1. Tool-Parameter model - wenn der Agent im Aufruf einen angibt.
2. videoGenerationModel.primary aus der Konfiguration.
3. videoGenerationModel.fallbacks der Reihe nach.
4. Automatische Erkennung - Provider mit gültiger Authentifizierung, beginnend mit dem aktuellen Standard-Provider, anschließend verbleibende Provider in alphabetischer Reihenfolge.

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "google/veo-3.1-fast-generate-preview",
        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],
      },
    },
  },
}

​

Provider-Hinweise

​

Provider-Fähigkeitsmodi

capabilities: {
  generate: {
    maxVideos: 1,
    maxDurationSeconds: 10,
    supportsResolution: true,
  },
  imageToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputImages: 1,
    maxInputImagesByModel: { "provider/reference-to-video": 9 },
    maxDurationSeconds: 5,
  },
  videoToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputVideos: 1,
    maxDurationSeconds: 5,
  },
}

​

Live-Tests

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

pnpm test:live:media video

• generate für jeden Nicht-FAL-Provider in der Prüfung.
• Einsekündiger Hummer-Prompt.
• Vorgangslimit pro Provider aus OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS (standardmäßig 180000).

pnpm test:live:media video --video-providers fal

• imageToVideo, wenn capabilities.imageToVideo.enabled.
• videoToVideo, wenn capabilities.videoToVideo.enabled und das Provider-/Modell pufferbasierte lokale Videoeingabe in der gemeinsamen Prüfung akzeptiert.

​

Konfiguration

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "qwen/wan2.6-t2v",
        fallbacks: ["qwen/wan2.6-r2v-flash"],
      },
    },
  },
}

openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2v"

​

Verwandt

• Alibaba Model Studio
• Hintergrundaufgaben - Aufgabenverfolgung für asynchrone Videogenerierung
• BytePlus
• ComfyUI
• Konfigurationsreferenz
• fal
• Google (Gemini)
• MiniMax
• Modelle
• OpenAI
• Qwen
• Runway
• Together AI
• Tools-Übersicht
• Vydra
• xAI