跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 隨附內建的 fal provider，用於託管式圖片與影片生成。
屬性值
Providerfal
驗證FAL_KEY（標準；FAL_API_KEY 也可作為備援）
APIfal 模型端點

​
開始使用

1

設定 API 金鑰

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

設定預設圖片模型

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

​
圖片生成

內建的 fal 圖片生成 provider 預設為 fal/fal-ai/flux/dev。
功能值
最大圖片數每個請求 4 張
編輯模式Flux：1 張參考圖片；GPT Image 2：10；Nano Banana 2：14
尺寸覆寫支援
長寬比支援生成與 GPT Image 2/Nano Banana 2 編輯
解析度支援
輸出格式png 或 jpeg
Flux 圖片轉圖片請求不支援 aspectRatio 覆寫。GPT Image 2 與 Nano Banana 2 編輯請求使用 fal 的 /edit 端點，並接受 長寬比提示。
當你想要 PNG 輸出時，請使用 outputFormat: "png"。fal 未在 OpenClaw 中宣告 明確的透明背景控制，因此對 fal 模型而言，background: "transparent" 會被回報為已忽略的覆寫。 若要使用 fal 作為預設圖片 provider： 
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/fal-ai/flux/dev",
      },
    },
  },
}

​
影片生成

內建的 fal 影片生成 provider 預設為 fal/fal-ai/minimax/video-01-live。
功能值
模式文字轉影片、單張圖片參考、Seedance 參考轉影片
執行階段適用於長時間執行工作的佇列式提交/狀態/結果流程
HeyGen video-agent：
  • fal/fal-ai/heygen/v2/video-agent
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
{
  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",
      },
    },
  },
}
使用 openclaw models list --provider fal 查看可用 fal 模型的完整清單，包括任何最近新增的項目。

​
相關

圖片生成

共用圖片工具參數與 provider 選擇。

影片生成

共用影片工具參數與 provider 選擇。

設定參考

Agent 預設值，包括圖片與影片模型選擇。