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。

在 fal 的請求結構描述中，Krea 2 提供長寬比而非 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 會同時拒絕歌詞與純音樂模式。

相關內容