OpenClaw 内置的 fal Provider 支持图片、视频和音乐生成，适用于需要快速接入托管模型（如 FLUX、MiniMax、Seedance、ACE-Step）的开发者。配置时需要先设置 FAL_KEY 环境变量（openclaw onboard --auth-choice fal-api-key），然后通过 agent defaults 指定默认模型。fal 图片生成默认使用 fal/fal-ai/flux/dev，视频默认使用 fal/fal-ai/minimax/video-01-live，音乐默认使用 fal/fal-ai/minimax-music/v2.6。关键限制：Flux 图生图不支持 aspectRatio 覆盖；图片最多 4 张/请求；视频为队列式后端，适合长时间任务。

OpenClaw fal Provider 配置：图片、视频、音乐生成与 FAL_KEY 认证

属性	值
Provider	fal
认证方式	FAL_KEY（推荐；FAL_API_KEY 也支持作为回退）
API 类型	fal 模型端点

快速开始

1. 设置 API Key

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

2. 设置默认图片模型

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

图片生成

内置 fal 图片生成 Provider 默认使用 fal/fal-ai/flux/dev。

能力	值
每请求最多图片数	4 张
编辑模式	Flux：1 张参考图片；GPT Image 2：10 张；Nano Banana 2：14 张
尺寸覆盖	支持
长宽比	支持 generate 和 GPT Image 2 / Nano Banana 2 编辑模式
分辨率	支持
输出格式	png 或 jpeg

注意：

• Flux 图生图请求不支持 aspectRatio 覆盖。GPT Image 2 和 Nano Banana 2 编辑请求使用 fal 的 /edit 端点，接受长宽比提示。
• 需输出 PNG 时使用 outputFormat: "png"。fal 在 OpenClaw 中未声明明确的透明背景控制，因此 background: "transparent" 会被报告为被忽略的覆盖项。

将 fal 设为默认图片 Provider 的完整配置：

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

视频生成

内置 fal 视频生成 Provider 默认使用 fal/fal-ai/minimax/video-01-live。

能力	值
模式	文生视频、单张参考图片、Seedance 参考图生成视频
运行时	队列式提交/状态查询/结果获取，适合长时间运行任务

可用的视频模型

**HeyGen 视频智能体：**
- `fal/fal-ai/heygen/v2/video-agent`

**Seedance 2.0：**
- `fal/bytedance/seedance-2.0/fast/text-to-video`
- `fal/bytedance/seedance-2.0/fast/image-to-video`
- `fal/bytedance/seedance-2.0/fast/reference-to-video`
- `fal/bytedance/seedance-2.0/text-to-video`
- `fal/bytedance/seedance-2.0/image-to-video`
- `fal/bytedance/seedance-2.0/reference-to-video`

Seedance 2.0 配置示例

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

Seedance 2.0 参考图生成视频配置示例

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

参考图生成视频模式最多接受 9 张图片、3 个视频和 3 个音频参考，通过 `video_generate` 的 `images`、`videos`、`audioRefs` 参数传递，总参考文件数不超过 12 个。

HeyGen 视频智能体配置示例

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

音乐生成

fal 插件还注册了音乐生成 Provider，用于共享的 music_generate 工具。

能力	值
默认模型	fal/fal-ai/minimax-music/v2.6
可用模型	fal-ai/minimax-music/v2.6、fal-ai/ace-step/prompt-to-audio、fal-ai/stable-audio-25/text-to-audio
运行时	同步请求 + 下载生成的音频

将 fal 设为默认音乐 Provider：

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "fal/fal-ai/minimax-music/v2.6",
      },
    },
  },
}

fal-ai/minimax-music/v2.6 支持显式歌词和纯音乐模式。ACE-Step 和 Stable Audio 是端到端提示转音频端点，需要通过 model 覆盖指定使用这些模型家族。

<期> 使用 openclaw models list --provider fal 查看所有可用 fal 模型的完整列表，包括最近新增的模型。 </期>

延伸阅读

图片生成

共享图片工具参数和 Provider 选择。

视频生成

共享视频工具参数和 Provider 选择。

音乐生成

共享音乐工具参数和 Provider 选择。

配置参考

智能体默认值设置，包括图片、视频、音乐模型选择。

常见问题

怎么知道我的 FAL_KEY 是否正确设置？

运行 openclaw onboard --auth-choice fal-api-key 后，如果认证失败，会提示错误信息。也可以手动检查环境变量 FAL_KEY 或 FAL_API_KEY 是否已正确导出。如果未设置，OpenClaw 会在启动时抛出认证相关错误。

图片生成时提示 "aspectRatio 覆盖被忽略" 怎么办？

如果你使用的是 Flux 图生图模式（image-to-image），aspectRatio 覆盖不支持，忽略是正常行为。如果使用 GPT Image 2 或 Nano Banana 2 编辑模式，则支持长宽比提示。检查你是否上传了参考图片并进入了编辑模式。

视频生成后一直显示 "queued" 状态是什么原因？

fal 视频生成为队列式后端，长视频任务可能需要几分钟到十几分钟。OpenClaw 会定期轮询状态，请等待结果。如果长时间无响应，检查日志（openclaw doctor）确认 API 是否可达以及队列是否堆积。