​

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 finito nella conversazione originale.

​

Ciclo di vita dell’attività

1. queued — attività creata, in attesa che il provider la accetti.
2. running — il provider è in elaborazione (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 immagine di riferimento: imageToVideo
• Qualsiasi video di riferimento: videoToVideo

​

Azioni

• generate (predefinita) — crea un video dal prompt indicato 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 provider, modelli e relative capacità disponibili.

​

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 con auth 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à dei 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 nel sweep
• imageToVideo quando capabilities.imageToVideo.enabled
• videoToVideo quando capabilities.videoToVideo.enabled e il provider/modello accetta input video locali basati su buffer nello sweep condiviso

• 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 — tracciamento delle attività per la generazione video asincrona
• Alibaba Model Studio
• BytePlus
• ComfyUI
• fal
• Google (Gemini)
• MiniMax
• OpenAI
• Qwen
• Runway
• Together AI
• Vydra
• xAI
• Configuration Reference
• Models