Fal

OpenClaw 内置了一个 fal 提供商，用于托管式图像、视频和音乐生成。

入门指南

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

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

图像生成

内置的 fal 图像生成提供商默认使用 fal/fal-ai/flux/dev。

编辑请求（通过共享的 image / images 参数提供参考图像） 会路由到每个模型对应的编辑端点，并带有每个模型的参考数量限制：

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。

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

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

音乐生成

内置的 fal 插件还为共享的 music_generate 工具注册了一个音乐生成提供商。

将 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 会同时拒绝 歌词和纯音乐模式。

相关