nyrn
/
openclaw
mirror of https://github.com/openclaw/openclaw.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
openclaw/docs/providers/fal.md

1.8 KiB
Raw Blame History

title summary read_when
fal fal image and video generation setup in OpenClaw
You want to use fal image generation in OpenClaw
You need the FAL_KEY auth flow
You want fal defaults for image_generate or video_generate

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

Related