Skip to main content
OpenClaw 内置了一个 fal 提供商，用于托管式图像、视频和音乐生成。
属性值
提供商fal
凭证FAL_KEY（规范键；FAL_API_KEY 也可作为回退使用）
APIfal 模型端点（https://fal.run；视频任务使用 https://queue.fal.run）
基础 URL使用 models.providers.fal.baseUrl 覆盖

​
入门指南

1

设置 API key

openclaw onboard --auth-choice fal-api-key
非交互式设置可以传入 --fal-api-key <key>，或导出 FAL_KEY。 新手引导还会在未配置默认图像模型时，将 fal/fal-ai/flux/dev 设为默认图像模型。
2

设置默认图像模型

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

​
图像生成

内置的 fal 图像生成提供商默认使用 fal/fal-ai/flux/dev。
能力值
最大图像数每次请求 4 张；Krea 2：每次请求 1 张
尺寸覆盖1024x1024、1024x1536、1536x1024、1024x1792、1792x1024
宽高比除 Flux 图像到图像外，所有场景均支持
分辨率1K、2K、4K（每个模型的限制见下文）
输出格式png（默认）或 jpeg；Krea 2 拒绝 outputFormat 覆盖
编辑请求（通过共享的 image / images 参数提供参考图像） 会路由到每个模型对应的编辑端点，并带有每个模型的参考数量限制：
模型系列fal/ 后的模型引用编辑端点最大参考图像数
Flux 和其他 fal 模型fal-ai/flux/dev（默认）/image-to-image1
GPT Imageopenai/gpt-image-*/edit10
Grok Imaginexai/grok-imagine-image/edit3
Nano Banana（旧版）fal-ai/nano-banana/edit3
Nano Banana 2fal-ai/nano-banana-*/edit14
Nano Banana 2 Litegoogle/nano-banana-2-lite/edit14
Krea 2krea/v2/{medium,large}/text-to-image无（风格参考）10 个风格参考
Flux 图像到图像请求不支持 aspectRatio 覆盖。GPT Image 和 Nano Banana 2 编辑请求使用 fal 的 /edit 端点，并接受 宽高比提示。Nano Banana 2 还接受额外的原生宽/高比例， 例如 4:1、1:4、8:1 和 1:8；Krea 2 会验证自己更小的 宽高比子集。Grok Imagine 有自己的比例列表（包括 2:1、 20:9、19.5:9 及其反向比例），并且只接受 1K/2K 分辨率； 旧版 Nano Banana 和 Nano Banana 2 Lite 会拒绝 resolution 覆盖。
Krea 2 模型使用 fal 的原生 Krea 载荷架构。OpenClaw 会发送 aspect_ratio、creativity 和 image_style_references，而不是 Flux 使用的通用 image_size / 编辑端点载荷。模型引用如下：
  • fal/krea/v2/medium/text-to-image
  • fal/krea/v2/large/text-to-image
对于更快的表现性插画、动漫、绘画和艺术风格，请使用 Medium。 对于较慢的照片级真实感、原始纹理、胶片颗粒和细节外观，请使用 Large。 Krea 默认使用 fal.creativity: "medium"；支持的值为 raw、low、medium 和 high。 Krea 2 在 fal 的请求架构中暴露的是宽高比，而不是 image_size。优先使用 aspectRatio；OpenClaw 会将 size 映射到最接近的受支持 Krea 宽高比， 并且会拒绝 Krea 的 resolution，而不是静默丢弃它。 当你希望从暴露 output_format 的 fal 模型获得 PNG 输出时，请使用 outputFormat: "png"。fal 没有在 OpenClaw 中声明显式的透明背景 控制，因此对于 fal 模型，background: "transparent" 会被报告为被忽略的 覆盖。 Krea 2 端点没有通过 fal 暴露 output_format 请求字段，因此 OpenClaw 会拒绝 Krea 请求中的 outputFormat 覆盖。 使用 Krea 2 Medium： 
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/krea/v2/medium/text-to-image",
      },
    },
  },
}

​
视频生成

内置的 fal 视频生成提供商默认使用 fal/fal-ai/minimax/video-01-live。
能力值
模式文本到视频、单图像参考、Seedance 参考到视频
运行时面向长时间运行任务的队列支持型提交/状态/结果流程
超时默认每个任务 20 分钟；每 5 秒轮询一次状态
MiniMax（默认）：
  • fal/fal-ai/minimax/video-01-live
HeyGen video-agent：
  • fal/fal-ai/heygen/v2/video-agent
Kling 和 Wan：
  • fal/fal-ai/kling-video/v2.1/master/text-to-video
  • fal/fal-ai/wan/v2.2-a14b/text-to-video
  • fal/fal-ai/wan/v2.2-a14b/image-to-video
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
MiniMax Live 和 HeyGen 请求只发送提示词和可选的 单张参考图像；其他覆盖不会被转发。Seedance 模型 接受 aspectRatio、size、resolution、4-15 秒的时长，以及 音频开关。
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
      },
    },
  },
}

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
      },
    },
  },
}
参考到视频通过共享的 video_generate images、videos 和 audioRefs 参数接受最多 9 张图像、3 个视频和 3 个音频参考， 总参考文件数最多为 12 个。音频参考要求同一请求中 至少有一个图像或视频参考。
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/fal-ai/heygen/v2/video-agent",
      },
    },
  },
}

​
音乐生成

内置的 fal 插件还为共享的 music_generate 工具注册了一个音乐生成提供商。
能力值
默认模型fal/fal-ai/minimax-music/v2.6
模型fal-ai/minimax-music/v2.6（mp3）、fal-ai/ace-step/prompt-to-audio（wav）、fal-ai/stable-audio-25/text-to-audio（wav）
最大时长240 秒
运行时同步请求加生成音频下载
将 fal 用作默认音乐提供商： 
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "fal/fal-ai/minimax-music/v2.6",
      },
    },
  },
}
fal-ai/minimax-music/v2.6 支持显式歌词和纯音乐模式， 但同一请求中不能同时使用二者。ACE-Step 和 Stable Audio 是 提示词到音频端点；当你需要这些模型系列时，请通过 model 覆盖选择它们。 ACE-Step 会拒绝显式歌词；Stable Audio 会同时拒绝 歌词和纯音乐模式。
上面的表格和折叠面板覆盖了内置 fal 提供商会特殊处理的模型系列。 其他 fal 图像端点 ID 仍然可以被选作图像模型；它们会被当作 Flux 处理 （通用 image_size 载荷，通过 /image-to-image 使用一张参考图像）。

​
相关

图像生成

共享图像工具参数和提供商选择。

视频生成

共享视频工具参数和提供商选择。

音乐生成

共享音乐工具参数和提供商选择。

配置参考

Agent 默认值，包括图像、视频和音乐模型选择。