​

Generazione video

• generate per richieste text-to-video senza media di riferimento
• imageToVideo quando la richiesta include una o più immagini di riferimento
• videoToVideo quando la richiesta include uno o più video di riferimento

​

Avvio rapido

1. Imposta una chiave API per qualsiasi provider supportato:

export GEMINI_API_KEY="your-key"

2. Facoltativamente, fissa un modello predefinito:

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

3. Chiedi all’agente:

Genera un video cinematografico di 5 secondi di un’aragosta amichevole che fa surf al tramonto.

​

Cosa succede quando generi un video

1. OpenClaw invia la richiesta al provider e restituisce immediatamente un ID attività.
2. Il provider elabora il job in background (in genere da 30 secondi a 5 minuti a seconda del provider e della risoluzione).
3. Quando il video è pronto, OpenClaw riattiva la stessa sessione con un evento interno di completamento.
4. L’agente pubblica il video completato nella conversazione originale.

​

Ciclo di vita dell’attività

1. queued — attività creata, in attesa che il provider la accetti.
2. running — il provider sta elaborando (in genere da 30 secondi a 5 minuti a seconda del provider e della risoluzione).
3. succeeded — video pronto; l’agente si riattiva e lo pubblica nella conversazione.
4. failed — errore del provider o timeout; l’agente si riattiva con i dettagli dell’errore.

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

​

Provider supportati

​

Matrice delle capacità dichiarate

​

Parametri dello strumento

​

Obbligatori

​

Input di contenuto

​

Controlli di stile

​

Avanzati

• Nessun media di riferimento: generate
• Qualsiasi riferimento immagine: imageToVideo
• Qualsiasi riferimento video: videoToVideo
• Gli input audio di riferimento non cambiano la modalità risolta; si applicano sopra qualunque modalità selezionata dai riferimenti immagine/video e funzionano solo con provider che dichiarano maxInputAudios

​

Fallback e opzioni tipizzate

• Se il candidato attivo non dichiara maxInputAudios (oppure lo dichiara come 0), viene saltato quando la richiesta contiene riferimenti audio, e si prova il candidato successivo.
• Se maxDurationSeconds del candidato attivo è inferiore ai durationSeconds richiesti e il candidato non dichiara una lista supportedDurationSeconds, viene saltato.
• Se la richiesta contiene providerOptions e il candidato attivo dichiara esplicitamente uno schema tipizzato providerOptions, il candidato viene saltato quando le chiavi fornite non sono nello schema o i tipi dei valori non corrispondono. I provider che non hanno ancora dichiarato uno schema ricevono le opzioni così come sono (pass-through retrocompatibile). Un provider può rinunciare esplicitamente a tutte le opzioni del provider dichiarando uno schema vuoto (capabilities.providerOptions: {}), che causa lo stesso salto di una incompatibilità di tipo.

​

Azioni

• generate (predefinito) — crea un video a partire dal prompt fornito e dagli eventuali input di riferimento.
• status — controlla lo stato dell’attività video in corso per la sessione corrente senza avviare un’altra generazione.
• list — mostra i provider disponibili, i modelli e le loro capacità.

​

Selezione del modello

1. Parametro dello strumento model — se l’agente ne specifica uno nella chiamata.
2. videoGenerationModel.primary — dalla configurazione.
3. videoGenerationModel.fallbacks — provati in ordine.
4. Rilevamento automatico — usa i provider che hanno autenticazione valida, iniziando dal provider predefinito corrente, poi i provider rimanenti in ordine alfabetico.

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

​

Note sui provider

​

Modalità di capacità del provider

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,
  },
}

​

Test live

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

pnpm test:live:media video

• generate per ogni provider non-FAL nella sweep
• prompt di un’aragosta di un secondo
• limite di operazioni per provider da OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS (180000 per impostazione predefinita)

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

• imageToVideo quando capabilities.imageToVideo.enabled
• videoToVideo quando capabilities.videoToVideo.enabled e il provider/modello accetta input video locale supportato da buffer nella sweep condivisa

• runway solo quando selezioni runway/gen4_aleph

​

Configurazione

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

​

Correlati

• Panoramica degli strumenti
• Attività in background — monitoraggio delle attività per la generazione video asincrona
• Alibaba Model Studio
• BytePlus
• ComfyUI
• fal
• Google (Gemini)
• MiniMax
• OpenAI
• Qwen
• Runway
• Together AI
• Vydra
• xAI
• Riferimento della configurazione
• Modelli