Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw inclui um provedor runway agrupado para geração de vídeo hospedada. O Plugin é habilitado por padrão e registra o provedor runway no contrato videoGenerationProviders.
PropriedadeValor
ID do provedorrunway
Pluginagrupado, enabledByDefault: true
Variáveis de ambiente authRUNWAYML_API_SECRET (canônica) ou RUNWAY_API_KEY
Flag de onboarding--auth-choice runway-api-key
Flag direta da CLI--runway-api-key <key>
APIgeração de vídeo baseada em tarefas da Runway (polling de GET /v1/tasks/{id})
Modelo padrãorunway/gen4.5

​
Primeiros passos

1

Defina a chave da API

openclaw onboard --auth-choice runway-api-key
2

Defina Runway como o provedor de vídeo padrão

openclaw config set agents.defaults.videoGenerationModel.primary "runway/gen4.5"
3

Gere um vídeo

Peça ao agente para gerar um vídeo. Runway será usado automaticamente.

​
Modos e modelos compatíveis

O provedor expõe sete modelos da Runway divididos em três modos. O mesmo ID de modelo pode atender a mais de um modo (por exemplo, gen4.5 funciona tanto para texto para vídeo quanto para imagem para vídeo).
ModoModelosEntrada de referência
Texto para vídeogen4.5 (padrão), veo3.1, veo3.1_fast, veo3Nenhuma
Imagem para vídeogen4.5, gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast, veo31 imagem local ou remota
Vídeo para vídeogen4_aleph1 vídeo local ou remoto
Referências locais de imagem e vídeo são compatíveis via URIs de dados.
Proporções de telaValores permitidos
Texto para vídeo16:9, 9:16
Edições de imagem e vídeo1:1, 16:9, 9:16, 3:4, 4:3, 21:9
Vídeo para vídeo atualmente exige runway/gen4_aleph. Outros IDs de modelo da Runway rejeitam entradas de referência de vídeo.
Escolher um ID de modelo da Runway da coluna errada produz um erro explícito antes que a solicitação da API saia do OpenClaw. O provedor valida model contra a lista de permissões do modo (TEXT_ONLY_MODELS, IMAGE_MODELS, VIDEO_MODELS) em extensions/runway/video-generation-provider.ts.

​
Configuração

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "runway/gen4.5",
      },
    },
  },
}

​
Configuração avançada

OpenClaw reconhece tanto RUNWAYML_API_SECRET (canônica) quanto RUNWAY_API_KEY. Qualquer uma das variáveis autenticará o provedor Runway.
Runway usa uma API baseada em tarefas. Depois de enviar uma solicitação de geração, OpenClaw faz polling de GET /v1/tasks/{id} até que o vídeo esteja pronto. Nenhuma configuração adicional é necessária para o comportamento de polling.

​
Relacionado

Geração de vídeo

Parâmetros de ferramenta compartilhados, seleção de provedor e comportamento assíncrono.

Referência de configuração

Configurações padrão do agente, incluindo o modelo de geração de vídeo.