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。

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 中未宣告明確的透明背景 控制項，因此 background: "transparent" 會被回報為 fal 模型中已忽略的 覆寫。 Krea 2 端點未透過 fal 公開 output_format 請求欄位，因此 OpenClaw 會拒絕 Krea 請求的 outputFormat 覆寫。

若要將 fal 作為預設影像提供者：

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

若要使用 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 覆寫來選擇它們。

相關