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 fal integrado para geração hospedada de imagens e vídeos.
PropriedadeValor
Provedorfal
AutenticaçãoFAL_KEY (canônico; FAL_API_KEY também funciona como alternativa)
APIendpoints de modelo fal

​
Primeiros passos

1

Defina a chave de API

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

Defina um modelo de imagem padrão

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/fal-ai/flux/dev",
      },
    },
  },
}

​
Geração de imagens

O provedor de geração de imagens fal integrado usa como padrão fal/fal-ai/flux/dev.
CapacidadeValor
Máximo de imagens4 por solicitação
Modo de ediçãoFlux: 1 imagem de referência; GPT Image 2: 10; Nano Banana 2: 14
Substituições de tamanhoCompatível
ProporçãoCompatível para geração e edição com GPT Image 2/Nano Banana 2
ResoluçãoCompatível
Formato de saídapng ou jpeg
Solicitações de imagem para imagem no Flux não são compatíveis com substituições de aspectRatio. Solicitações de edição do GPT Image 2 e Nano Banana 2 usam o endpoint /edit da fal e aceitam dicas de proporção.
Use outputFormat: "png" quando quiser saída em PNG. A fal não declara um controle explícito de fundo transparente no OpenClaw, portanto background: "transparent" é relatado como uma substituição ignorada para modelos fal. Para usar a fal como provedora de imagens padrão: 
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/fal-ai/flux/dev",
      },
    },
  },
}

​
Geração de vídeos

O provedor de geração de vídeos fal integrado usa como padrão fal/fal-ai/minimax/video-01-live.
CapacidadeValor
ModosTexto para vídeo, referência de imagem única, referência para vídeo Seedance
RuntimeFluxo de envio/status/resultado baseado em fila para trabalhos de longa duração
HeyGen video-agent:
  • fal/fal-ai/heygen/v2/video-agent
Seedance 2.0:
  • fal/bytedance/seedance-2.0/fast/text-to-video
  • fal/bytedance/seedance-2.0/fast/image-to-video
  • fal/bytedance/seedance-2.0/fast/reference-to-video
  • fal/bytedance/seedance-2.0/text-to-video
  • fal/bytedance/seedance-2.0/image-to-video
  • fal/bytedance/seedance-2.0/reference-to-video
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
      },
    },
  },
}

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
      },
    },
  },
}
Referência para vídeo aceita até 9 imagens, 3 vídeos e 3 referências de áudio por meio dos parâmetros compartilhados video_generate images, videos e audioRefs, com no máximo 12 arquivos de referência no total.
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/fal-ai/heygen/v2/video-agent",
      },
    },
  },
}
Use openclaw models list --provider fal para ver a lista completa de modelos fal disponíveis, incluindo entradas adicionadas recentemente.

​
Relacionados

Geração de imagens

Parâmetros compartilhados da ferramenta de imagem e seleção de provedor.

Geração de vídeos

Parâmetros compartilhados da ferramenta de vídeo e seleção de provedor.

Referência de configuração

Padrões do agente, incluindo seleção de modelos de imagem e vídeo.