Videogenerierung

• generate – keine Referenzmedien (Text-zu-Video).
• imageToVideo – ein oder mehrere Referenzbilder.
• videoToVideo – ein oder mehrere Referenzvideos.

​

Schnellstart

export GEMINI_API_KEY="your-key"

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

​

Funktionsweise der asynchronen 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 (je nach Provider und Auflösung normalerweise 30 Sekunden bis mehrere Minuten; langsame warteschlangenbasierte Provider können bis zum konfigurierten Timeout laufen).
3. Sobald das Video bereit ist, aktiviert OpenClaw dieselbe Sitzung mit einem internen Abschlussereignis.
4. Der Agent meldet es über den normalen Modus der Sitzung für sichtbare Antworten: als automatische abschließende Antwort oder über message(action="send"), wenn die Sitzung das Nachrichten-Tool erfordert. Wenn die anfragende Sitzung inaktiv ist oder ihre Aktivierung fehlschlägt und die generierten Medien weiterhin in der Abschlussantwort fehlen, sendet OpenClaw einen idempotenten direkten Fallback mit den Medien.

​

Aufgabenlebenszyklus

openclaw tasks list
openclaw tasks show <lookup>
openclaw tasks cancel <lookup>

​

Unterstützte Provider

​

Funktionsmatrix

​

Tool-Parameter

​

Erforderlich

​

Inhaltseingaben

​

Stilsteuerung

​

Erweitert

• Keine Referenzmedien -> generate
• Beliebige Bildreferenz -> imageToVideo
• Beliebige Videoreferenz -> videoToVideo
• Referenzaudioeingaben ändern den aufgelösten Modus nicht; sie werden zusätzlich zu dem Modus angewendet, den die Bild-/Videoreferenzen bestimmen, und funktionieren nur mit Providern, die maxInputAudios deklarieren.

​

Fallback und typisierte Optionen

• Ein aktiver Kandidat, der kein maxInputAudios (oder 0) deklariert, wird übersprungen, wenn die Anfrage Audioreferenzen enthält; der nächste Kandidat wird versucht. Dieselbe Prüfung gilt für die Anzahl der Bild- und Videoreferenzen gegenüber maxInputImages/maxInputVideos.
• Liegt maxDurationSeconds des aktiven Kandidaten unter dem angeforderten durationSeconds und ist keine supportedDurationSeconds-Liste deklariert, wird er übersprungen.
• Enthält die Anfrage providerOptions und deklariert der aktive Kandidat ausdrücklich ein typisiertes providerOptions-Schema, wird er übersprungen, wenn die angegebenen Schlüssel nicht im Schema enthalten sind oder die Werttypen nicht übereinstimmen. Provider ohne deklariertes Schema erhalten die Optionen unverändert (abwärtskompatible Durchleitung). Ein Provider kann sämtliche Provideroptionen ablehnen, indem er ein leeres Schema (capabilities.providerOptions: {}) deklariert; dies führt zum gleichen Überspringen wie eine Typabweichung.

​

Aktionen

​

Modellauswahl

1. Werkzeugparameter model – falls der Agent einen im Aufruf 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, danach die übrigen Provider in alphabetischer Reihenfolge.

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "google/veo-3.1-fast-generate-preview",
        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],
        timeoutMs: 180000, // optionale auf das Werkzeug bezogene Überschreibung der Zeitüberschreitung für Provider-Anfragen
      },
    },
  },
}

​

Hinweise zu Providern

​

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 im Durchlauf.
• Einsekündiger Lobster-Prompt.
• Grenzwert für Vorgänge 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 der Provider bzw. das Modell im gemeinsamen Durchlauf puffergestützte lokale Videoeingaben akzeptiert.

​

Konfiguration

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

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

​

Verwandte Themen

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