Skip to content

fal

fal

OpenClaw ships a bundled fal provider for hosted image and video generation.

Provider: fal
Auth: FAL_KEY (canonical; FAL_API_KEY also works as a fallback)
API: fal model endpoints

Quick start

Set the API key:

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

Set a default image model:

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

Image generation

The bundled fal image-generation provider defaults to fal/fal-ai/flux/dev.

Generate: up to 4 images per request
Edit mode: enabled, 1 reference image
Supports size, aspectRatio, and resolution
Current edit caveat: the fal image edit endpoint does not support aspectRatio overrides

To use fal as the default image provider:

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

Video generation

The bundled fal video-generation provider defaults to fal/fal-ai/minimax/video-01-live.

Modes: text-to-video and single-image reference flows
Runtime: queue-backed submit/status/result flow for long-running jobs

To use fal as the default video provider:

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/fal-ai/minimax/video-01-live",
      },
    },
  },
}