跳轉到主要內容
OpenClaw 內建隨附 fal 提供者，用於託管式圖片、影片與音樂生成。
屬性值
提供者fal
驗證FAL_KEY（標準；FAL_API_KEY 也可作為備援使用）
APIfal 模型端點（https://fal.run；影片工作使用 https://queue.fal.run）
基底 URL使用 models.providers.fal.baseUrl 覆寫

​
開始使用

1

設定 API 金鑰

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 預設值，包含圖片、影片與音樂模型選擇。