Providers
Fal
O OpenClaw inclui um provedor fal integrado para geração hospedada de imagens e vídeos.
| Propriedade | Valor |
|---|---|
| Provedor | fal |
| Autenticação | FAL_KEY (canônico; FAL_API_KEY também funciona como fallback) |
| API | endpoints de modelo fal |
Primeiros passos
Defina a chave de API
openclaw onboard --auth-choice fal-api-key
Defina um modelo de imagem padrão
{
agents: {
defaults: {
imageGenerationModel: {
primary: "fal/fal-ai/flux/dev",
},
},
},
}
Geração de imagens
O provedor integrado de geração de imagens fal usa por padrão
fal/fal-ai/flux/dev.
| Capacidade | Valor |
|---|---|
| Máximo de imagens | 4 por solicitação |
| Modo de edição | Ativado, 1 imagem de referência |
| Substituições de tamanho | Compatível |
| Proporção | Compatível |
| Resolução | Compatível |
| Formato de saída | png ou jpeg |
Use outputFormat: "png" quando quiser saída em PNG. O fal não declara um
controle explícito de fundo transparente no OpenClaw, então background: "transparent" é informado como uma substituição ignorada para modelos fal.
Para usar o fal como provedor de imagem padrão:
{
agents: {
defaults: {
imageGenerationModel: {
primary: "fal/fal-ai/flux/dev",
},
},
},
}
Geração de vídeo
O provedor integrado de geração de vídeo fal usa por padrão
fal/fal-ai/minimax/video-01-live.
| Capacidade | Valor |
|---|---|
| Modos | Texto para vídeo, referência de imagem única, Seedance reference-to-video |
| Runtime | Fluxo de submit/status/result com fila para jobs de longa duração |
Modelos de vídeo disponíveis
HeyGen video-agent:
fal/fal-ai/heygen/v2/video-agent
Seedance 2.0:
fal/bytedance/seedance-2.0/fast/text-to-videofal/bytedance/seedance-2.0/fast/image-to-videofal/bytedance/seedance-2.0/fast/reference-to-videofal/bytedance/seedance-2.0/text-to-videofal/bytedance/seedance-2.0/image-to-videofal/bytedance/seedance-2.0/reference-to-video
Exemplo de configuração do Seedance 2.0
{
agents: {
defaults: {
videoGenerationModel: {
primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
},
},
},
}
Exemplo de configuração do Seedance 2.0 reference-to-video
{
agents: {
defaults: {
videoGenerationModel: {
primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
},
},
},
}
O reference-to-video 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.
Exemplo de configuração do HeyGen video-agent
{
agents: {
defaults: {
videoGenerationModel: {
primary: "fal/fal-ai/heygen/v2/video-agent",
},
},
},
}