Pular para o conteúdo principal
O OpenClaw inclui um provedor fal embutido para geração hospedada de imagens, vídeos e música.
PropriedadeValor
Provedorfal
AutenticaçãoFAL_KEY (canônico; FAL_API_KEY também funciona como fallback)
APIendpoints de modelo fal

​
Primeiros passos

1

Definir a chave de API

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

Definir 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 embutido usa como padrão fal/fal-ai/flux/dev.
CapacidadeValor
Máximo de imagens4 por solicitação; Krea 2: 1 por solicitação
Modo de ediçãoFlux: 1 imagem de referência; GPT Image 2: 10; Nano Banana 2: 14
Referências de estiloKrea 2: até 10 referências de estilo via image / images
Substituições de tamanhoCompatíveis
ProporçãoCompatível para geração, Krea 2 e edição do GPT Image 2/Nano Banana 2
ResoluçãoCompatível
Formato de saídapng ou jpeg
Solicitações imagem para imagem do 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. O Nano Banana 2 também aceita proporções largas/altas nativas extras, como 4:1, 1:4, 8:1 e 1:8; o Krea 2 valida seu próprio subconjunto menor de proporções.
Os modelos Krea 2 usam o esquema de payload nativo da Krea na fal. O OpenClaw envia aspect_ratio, creativity e image_style_references em vez do payload genérico de image_size / endpoint de edição usado pelo Flux. As refs de modelo são:
  • fal/krea/v2/medium/text-to-image
  • fal/krea/v2/large/text-to-image
Use Medium para ilustração expressiva, anime, pintura e estilos artísticos mais rápidos. Use Large para visual fotorrealista mais lento, textura bruta, granulação de filme e aparências detalhadas. O Krea usa como padrão fal.creativity: "medium"; os valores compatíveis são raw, low, medium e high. O Krea 2 expõe proporção, não image_size, no esquema de solicitação da fal. Prefira aspectRatio; o OpenClaw mapeia size para a proporção Krea compatível mais próxima e rejeita resolution para o Krea em vez de descartá-la. Use outputFormat: "png" quando quiser saída PNG de modelos fal que expõem output_format. A fal não declara um controle explícito de fundo transparente no OpenClaw, então background: "transparent" é relatado como uma substituição ignorada para modelos fal. Os endpoints Krea 2 não expõem um campo de solicitação output_format pela fal, então o OpenClaw rejeita substituições de outputFormat para solicitações Krea. Para usar fal como provedor de imagens padrão: 
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/fal-ai/flux/dev",
      },
    },
  },
}
Para usar Krea 2 Medium: 
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/krea/v2/medium/text-to-image",
      },
    },
  },
}

​
Geração de vídeos

O provedor de geração de vídeos fal embutido usa como padrão fal/fal-ai/minimax/video-01-live.
CapacidadeValor
ModosTexto para vídeo, referência de imagem única, Seedance referência para vídeo
RuntimeFluxo de envio/status/resultado com 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",
      },
    },
  },
}

​
Geração de música

O Plugin fal incluído também registra um provedor de geração de música para a ferramenta compartilhada music_generate.
CapacidadeValor
Modelo padrãofal/fal-ai/minimax-music/v2.6
Modelosfal-ai/minimax-music/v2.6, fal-ai/ace-step/prompt-to-audio, fal-ai/stable-audio-25/text-to-audio
RuntimeSolicitação síncrona mais download do áudio gerado
Use fal como o provedor de música padrão: 
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "fal/fal-ai/minimax-music/v2.6",
      },
    },
  },
}
fal-ai/minimax-music/v2.6 oferece suporte a letras explícitas e modo instrumental. ACE-Step e Stable Audio são endpoints de prompt para áudio; escolha-os com a substituição model quando quiser essas famílias de modelos.
Use openclaw models list --provider fal para ver a lista completa de modelos fal disponíveis, incluindo quaisquer entradas adicionadas recentemente.

​
Relacionado

Geração de imagens

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

Geração de vídeo

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

Geração de música

Parâmetros da ferramenta de música compartilhada e seleção de provedor.

Referência de configuração

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