​

Geração de vídeo

• generate para solicitações de texto para vídeo sem mídia de referência
• imageToVideo quando a solicitação inclui uma ou mais imagens de referência
• videoToVideo quando a solicitação inclui um ou mais vídeos de referência

​

Início rápido

1. Defina uma chave de API para qualquer provedor compatível:

export GEMINI_API_KEY="your-key"

2. Opcionalmente, fixe um modelo padrão:

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

3. Peça ao agente:

Gere um vídeo cinematográfico de 5 segundos de uma lagosta amigável surfando ao pôr do sol.

​

O que acontece quando você gera um vídeo

1. O OpenClaw envia a solicitação ao provedor e retorna imediatamente um ID de tarefa.
2. O provedor processa o trabalho em segundo plano (normalmente de 30 segundos a 5 minutos, dependendo do provedor e da resolução).
3. Quando o vídeo está pronto, o OpenClaw reativa a mesma sessão com um evento interno de conclusão.
4. O agente publica o vídeo finalizado de volta na conversa original.

​

Ciclo de vida da tarefa

1. queued — tarefa criada, aguardando o provedor aceitá-la.
2. running — o provedor está processando (normalmente de 30 segundos a 5 minutos, dependendo do provedor e da resolução).
3. succeeded — vídeo pronto; o agente é reativado e o publica na conversa.
4. failed — erro do provedor ou timeout; o agente é reativado com detalhes do erro.

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

​

Provedores compatíveis

​

Matriz de capacidade declarada

​

Parâmetros da ferramenta

​

Obrigatórios

​

Entradas de conteúdo

​

Controles de estilo

​

Avançado

• Sem mídia de referência: generate
• Qualquer referência de imagem: imageToVideo
• Qualquer referência de vídeo: videoToVideo
• Entradas de áudio de referência não alteram o modo resolvido; elas se aplicam por cima do modo que as referências de imagem/vídeo selecionarem e só funcionam com provedores que declaram maxInputAudios

​

Fallback e opções tipadas

• Se o candidato ativo não declarar maxInputAudios (ou o declarar como 0), ele será ignorado quando a solicitação contiver referências de áudio, e o próximo candidato será tentado.
• Se maxDurationSeconds do candidato ativo estiver abaixo de durationSeconds solicitado e o candidato não declarar uma lista supportedDurationSeconds, ele será ignorado.
• Se a solicitação contiver providerOptions e o candidato ativo declarar explicitamente um schema tipado para providerOptions, o candidato será ignorado quando as chaves fornecidas não estiverem no schema ou os tipos dos valores não corresponderem. Provedores que ainda não declararam um schema recebem as opções como estão (pass-through compatível com versões anteriores). Um provedor pode optar explicitamente por não aceitar nenhuma opção de provedor declarando um schema vazio (capabilities.providerOptions: {}), o que causa a mesma omissão que uma incompatibilidade de tipo.

​

Ações

• generate (padrão) — cria um vídeo a partir do prompt fornecido e das entradas de referência opcionais.
• status — verifica o estado da tarefa de vídeo em andamento para a sessão atual sem iniciar outra geração.
• list — mostra os provedores, modelos e suas capacidades disponíveis.

​

Seleção de modelo

1. Parâmetro de ferramenta model — se o agente especificar um na chamada.
2. videoGenerationModel.primary — da configuração.
3. videoGenerationModel.fallbacks — tentados em ordem.
4. Detecção automática — usa provedores que têm autenticação válida, começando pelo provedor padrão atual e depois pelos provedores restantes em ordem alfabética.

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

​

Observações sobre provedores

​

Modos de capacidade do provedor

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

​

Testes ao vivo

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

pnpm test:live:media video

• generate para todo provedor não FAL na varredura
• prompt de lagosta de um segundo
• limite de operação por provedor vindo de OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS (180000 por padrão)

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

• imageToVideo quando capabilities.imageToVideo.enabled
• videoToVideo quando capabilities.videoToVideo.enabled e o provedor/modelo aceita entrada de vídeo local com buffer na varredura compartilhada

• runway apenas quando você seleciona runway/gen4_aleph

​

Configuração

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

​

Relacionado

• Visão geral das ferramentas
• Tarefas em segundo plano — rastreamento de tarefas para geração assíncrona de vídeo
• Alibaba Model Studio
• BytePlus
• ComfyUI
• fal
• Google (Gemini)
• MiniMax
• OpenAI
• Qwen
• Runway
• Together AI
• Vydra
• xAI
• Referência de configuração
• Modelos