Skip to main content

​
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

  1. Set the API key:
openclaw onboard --auth-choice fal-api-key
  1. 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",
      },
    },
  },
}