fal

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

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

Getting started

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

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

WARNING

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

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

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

Available video models

HeyGen video-agent:

Seedance 2.0:

Seedance 2.0 config example

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

HeyGen video-agent config example

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

TIP

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

Shared image tool parameters and provider selection.

Shared video tool parameters and provider selection.

Agent defaults including image and video model selection.