Videogenerierung

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.

• 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"

​

Funktionsweise der asynchronen Generierung

1. OpenClaw übermittelt die Anfrage an den Provider und gibt sofort eine Task-ID zurück.
2. Der Provider verarbeitet den Job im Hintergrund (typischerweise 30 Sekunden bis mehrere Minuten, abhängig von Provider und Auflösung; langsame warteschlangengestü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 und hängt das fertige Video an. In Gruppen-/Kanal-Chats, die eine nur über Message-Tools sichtbare Zustellung verwenden, leitet der Agent das Ergebnis über das Message-Tool weiter, statt dass OpenClaw es direkt postet.

​

Task-Lebenszyklus

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

​

Unterstützte Provider

​

Capability-Matrix

​

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 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 ohne deklarierte Liste supportedDurationSeconds → übersprungen.
• Anfrage enthält providerOptions und der aktive Kandidat deklariert explizit ein typisiertes providerOptions-Schema → übersprungen, wenn bereitgestellte Schlüssel nicht im Schema enthalten sind oder Werttypen nicht übereinstimmen. Provider ohne deklariertes Schema erhalten Optionen unverändert (rückwärtskompatible Durchleitung). Ein Provider kann alle Provider-Optionen deaktivieren, indem er ein leeres Schema deklariert (capabilities.providerOptions: {}), was denselben Sprung wie eine Typabweichung verursacht.

​

Aktionen

​

Modellauswahl

1. Tool-Parameter model - wenn 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, anschließend 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"],
      },
    },
  },
}

​

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 im Durchlauf.
• Einsekündiger Lobster-Prompt.
• Operationslimit 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 puffergestützte lokale Videoeingaben im gemeinsamen Durchlauf 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