Fal

O OpenClaw inclui um provedor fal embutido para geração hospedada de imagens, vídeos e música.

Primeiros passos

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

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

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.

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

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

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.

Relacionado