Configura el proveedor fal en OpenClaw: Guía rápida

¿Alguna vez has intentado integrar generación de medios y has terminado con un montón de código difícil de mantener? Configurar modelos de imagen y vídeo suele ser un proceso lento que te quita tiempo para construir lo que realmente importa.

OpenClaw incluye un provider de fal integrado para que puedas gestionar la generación de imágenes y vídeos de forma directa.

fal

OpenClaw incluye un provider de fal integrado para la generación de imágenes y vídeos alojados.

• Provider: fal
• Auth: FAL_KEY (canónica; FAL_API_KEY también funciona como respaldo)
• API: endpoints de modelos de fal

Inicio rápido

1. Configura la API key:

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

2. Configura un modelo de imagen por defecto:

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

Generación de imágenes

El provider de generación de imágenes de fal integrado utiliza por defecto fal/fal-ai/flux/dev. Te recomiendo este modelo si buscas un equilibrio entre velocidad y calidad visual.

• Genera: hasta 4 imágenes por petición
• Modo edición: habilitado, 1 imagen de referencia
• Soporta size, aspectRatio y resolution
• Advertencia actual sobre edición: el endpoint de edición de imágenes de fal no soporta cambios en aspectRatio.

Para usar fal como provider de imagen por defecto:

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

Generación de vídeo

El provider de generación de vídeo de fal integrado utiliza por defecto fal/fal-ai/minimax/video-01-live.

• Modos: flujos de text-to-video y referencia de imagen única
• Runtime: flujo de envío/estado/resultado basado en colas para tareas de larga duración
• Referencia del modelo HeyGen video-agent:
  • fal/fal-ai/heygen/v2/video-agent
• Referencias del modelo 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/text-to-video
  • fal/bytedance/seedance-2.0/image-to-video

Para usar Seedance 2.0 como modelo de vídeo por defecto:

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
      },
    },
  },
}

Para usar HeyGen video-agent como modelo de vídeo por defecto:

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/fal-ai/heygen/v2/video-agent",
      },
    },
  },
}

Relacionado

• Generación de imágenes
• Generación de vídeo
• Referencia de configuración

Siguientes pasos

• Explora la guía de Generación de imágenes.
• Configura flujos avanzados en Generación de vídeo.

AI Setup Assistant