使用 OpenClaw 整合 fal API：快速部署影像與影片生成功能

每次想在專案裡加入 AI 生成圖片或影片的功能，光是處理不同廠商的 API 串接和認證就讓人頭大。如果你正在找一個能快速整合高品質生成模型的方法，OpenClaw 內建的 fal 支援會是你的好幫手。

fal

OpenClaw 內建了 fal provider，讓你可以輕鬆使用託管的圖片與影片生成服務。

• Provider: fal
• Auth: FAL_KEY (主要使用這個；FAL_API_KEY 也可以作為備用)
• API: fal 模型端點

快速開始

1. 設定 API key：

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 張圖片
• 編輯模式：已啟用，支援 1 張參考圖
• 支援 size、aspectRatio 和 resolution
• 目前的編輯限制：fal 的圖片編輯端點不支援覆蓋 aspectRatio

如果你想將 fal 作為預設的圖片 provider：

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

影片生成

內建的 fal 影片生成 provider 預設使用 fal/fal-ai/minimax/video-01-live。

• 模式：支援文字轉影片 (text-to-video) 與單圖參考流程
• 執行方式：針對長時間任務採用佇列形式的提交/狀態/結果 (submit/status/result) 流程
• HeyGen 影片代理模型參考：
  • 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/text-to-video
  • fal/bytedance/seedance-2.0/image-to-video

將 Seedance 2.0 設定為預設影片模型：

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
      },
    },
  },
}

將 HeyGen video-agent 設定為預設影片模型：

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

相關文件

• Image Generation
• Video Generation
• Configuration Reference

想要更快速地完成設定嗎？直接詢問 AI Setup Assistant 吧！