Use this file to discover all available pages before exploring further.

Fal

OpenClaw ships a bundled

text

fal

provider for hosted image and video generation.

Property	Value
Provider	text `fal`
Auth	text `FAL_KEY` (canonical; text `FAL_API_KEY` also works as a fallback)
API	fal model endpoints

Getting started

Set the API key

```bash} openclaw onboard --auth-choice fal-api-key ```

Set a default image model

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

Image generation

The bundled

text

fal

image-generation provider defaults to

text

fal/fal-ai/flux/dev

Capability	Value
Max images	4 per request
Edit mode	Enabled, 1 reference image
Size overrides	Supported
Aspect ratio	Supported
Resolution	Supported
Output format	text `png` or text `jpeg`

warning

The fal image edit endpoint does **not** support `aspectRatio` overrides.

Use

text

outputFormat: "png"

when you want PNG output. fal does not declare an explicit transparent-background control in OpenClaw, so

text

background: "transparent"

is reported as an ignored override for fal models.

To use fal as the default image provider:


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

Video generation

The bundled

text

fal

video-generation provider defaults to

text

fal/fal-ai/minimax/video-01-live

Capability	Value
Modes	Text-to-video, single-image reference, Seedance reference-to-video
Runtime	Queue-backed submit/status/result flow for long-running jobs

tip

Use `openclaw models list --provider fal` to see the full list of available fal models, including any recently added entries.

Image generation

Shared image tool parameters and provider selection.

Video generation

Shared video tool parameters and provider selection.

Configuration reference

Agent defaults including image and video model selection.

OpenClaw Docs

Fal

Getting started

Set the API key

Set a default image model

Image generation

warning

Video generation

tip

Related

Image generation

Video generation

Configuration reference