​

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. Optional ein Standardmodell festlegen:

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

3. Fragen Sie den Agenten:

Erzeuge ein 5-sekündiges cineastisches 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 Task-ID zurück.
2. Der Provider verarbeitet den Job im Hintergrund (typischerweise 30 Sekunden bis 5 Minuten, abhängig von Provider und Auflösung).
3. Wenn das Video bereit ist, weckt OpenClaw dieselbe Sitzung mit einem internen Abschlussereignis auf.
4. Der Agent postet das fertige Video zurück in die ursprüngliche Unterhaltung.

​

Task-Lifecycle

1. queued — Task erstellt, wartet darauf, dass der Provider sie annimmt.
2. running — Provider verarbeitet die Anfrage (typischerweise 30 Sekunden bis 5 Minuten, abhängig von Provider und Auflösung).
3. succeeded — Video ist bereit; der Agent wird aufgeweckt und postet es in die Unterhaltung.
4. failed — Provider-Fehler oder Timeout; der Agent wird mit Fehlerdetails aufgeweckt.

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

​

Unterstützte Provider

​

Deklarierte Fähigkeitsmatrix

​

Tool-Parameter

​

Erforderlich

​

Inhaltseingaben

​

Stilsteuerung

​

Erweitert

• Keine Referenzmedien: generate
• Beliebige Bildreferenz: imageToVideo
• Beliebige Videoreferenz: videoToVideo

​

Aktionen

• generate (Standard) — ein Video aus dem angegebenen Prompt und optionalen Referenzeingaben erstellen.
• status — den Status des laufenden Video-Tasks 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. Tool-Parameter model — wenn der Agent beim Aufruf einen angibt.
2. videoGenerationModel.primary — aus der Konfiguration.
3. videoGenerationModel.fallbacks — werden in dieser Reihenfolge versucht.
4. Auto-Erkennung — verwendet 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"],
      },
    },
  },
}

​

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 Provider/Modell im gemeinsamen Sweep buffer-gestützte lokale Videoeingaben akzeptieren

• 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

• Tools Overview
• Background Tasks — Task-Verfolgung für asynchrone Videogenerierung
• Alibaba Model Studio
• BytePlus
• ComfyUI
• fal
• Google (Gemini)
• MiniMax
• OpenAI
• Qwen
• Runway
• Together AI
• Vydra
• xAI
• Configuration Reference
• Models