​

Videogenerierung

• generate für Text-zu-Video-Anfragen ohne Referenzmedien
• imageToVideo, wenn die Anfrage ein oder mehrere Referenzbilder enthält
• videoToVideo, wenn die Anfrage ein oder mehrere Referenzvideos enthält

​

Schnellstart

1. Setzen Sie einen API-Schlüssel für einen beliebigen unterstützten Provider:

export GEMINI_API_KEY="your-key"

2. Legen Sie optional ein Standardmodell fest:

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

3. Fragen Sie den Agenten:

Generiere ein 5-sekündiges filmisches Video eines freundlichen Hummers, der bei Sonnenuntergang surft.

​

Was passiert, wenn Sie ein Video generieren

1. OpenClaw sendet 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 5 Minuten, je nach Provider und Auflösung).
3. Wenn das Video bereit ist, reaktiviert OpenClaw dieselbe Sitzung mit einem internen Abschlussereignis.
4. Der Agent stellt das fertige Video zurück in die ursprüngliche Unterhaltung.

​

Aufgabenlebenszyklus

1. queued — Aufgabe erstellt, wartet darauf, dass der Provider sie annimmt.
2. running — Provider verarbeitet die Anfrage (typischerweise 30 Sekunden bis 5 Minuten, je nach Provider und Auflösung).
3. succeeded — Video bereit; der Agent wird reaktiviert und stellt es in die Unterhaltung.
4. failed — Provider-Fehler oder Zeitüberschreitung; der Agent wird mit Fehlerdetails reaktiviert.

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

​

Unterstützte Provider

​

Deklarierte Fähigkeitsmatrix

​

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 zusätzlich zu dem durch Bild-/Videoreferenzen gewählten Modus angewendet und funktionieren nur mit Providern, die maxInputAudios deklarieren

​

Fallback und typisierte Optionen

• Wenn der aktive Kandidat kein maxInputAudios deklariert (oder es als 0 deklariert), wird er übersprungen, wenn die Anfrage Audio-Referenzen enthält, und der nächste Kandidat wird versucht.
• Wenn maxDurationSeconds des aktiven Kandidaten unter den angeforderten durationSeconds liegt und der Kandidat keine supportedDurationSeconds-Liste deklariert, wird er übersprungen.
• Wenn die Anfrage providerOptions enthält und der aktive Kandidat ausdrücklich ein typisiertes providerOptions-Schema deklariert, wird der Kandidat übersprungen, wenn die angegebenen Schlüssel nicht im Schema enthalten sind oder die Werttypen nicht übereinstimmen. Provider, die noch kein Schema deklariert haben, erhalten die Optionen unverändert (rückwärtskompatibles Durchreichen). Ein Provider kann sich ausdrücklich von allen Provider-Optionen abmelden, indem er ein leeres Schema deklariert (capabilities.providerOptions: {}), was zum selben Überspringen wie bei einem Typkonflikt führt.

​

Aktionen

• generate (Standard) — ein Video aus dem angegebenen Prompt und optionalen Referenzeingaben erstellen.
• status — den Status der laufenden Videoaufgabe für die aktuelle Sitzung prüfen, ohne eine weitere Generierung zu starten.
• list — verfügbare Provider, Modelle und deren Fähigkeiten anzeigen.

​

Modellauswahl

1. model-Tool-Parameter — wenn der Agent in dem Aufruf einen angibt.
2. videoGenerationModel.primary — aus der Konfiguration.
3. videoGenerationModel.fallbacks — wird in der angegebenen Reihenfolge versucht.
4. Automatische Erkennung — verwendet Provider mit gültiger Authentifizierung, beginnend mit dem aktuellen Standard-Provider, dann 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"],
      },
    },
  },
}

​

Hinweise zu Providern

​

Provider-Fähigkeitsmodi

capabilities: {
  generate: {
    maxVideos: 1,
    maxDurationSeconds: 10,
    supportsResolution: true,
  },
  imageToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputImages: 1,
    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 Provider im Sweep
• imageToVideo, wenn capabilities.imageToVideo.enabled
• videoToVideo, wenn capabilities.videoToVideo.enabled und der Provider/das Modell im gemeinsamen Sweep pufferbasierte lokale Videoeingaben akzeptiert

• runway nur, wenn Sie runway/gen4_aleph auswählen

​

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

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