Providers

Fal

OpenClaw には、ホスト型の画像および動画生成用の同梱 fal プロバイダーが付属しています。

プロパティ	値
プロバイダー	`fal`
認証	`FAL_KEY`（標準。`FAL_API_KEY` もフォールバックとして機能）
API	fal モデルエンドポイント

はじめに

bash

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

json5

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

同梱の fal 画像生成プロバイダーのデフォルトは fal/fal-ai/flux/dev です。

機能	値
最大画像数	リクエストあたり 4
編集モード	Flux: 参照画像 1 枚、GPT Image 2: 10、Nano Banana 2: 14
サイズ上書き	サポート
アスペクト比	生成、および GPT Image 2/Nano Banana 2 編集でサポート
解像度	サポート
出力形式	`png` または `jpeg`

PNG 出力が必要な場合は outputFormat: "png" を使用します。fal は OpenClaw で明示的な透明背景制御を宣言していないため、fal モデルでは background: "transparent" は無視された上書きとして報告されます。

fal をデフォルトの画像プロバイダーとして使用するには:

json5

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

同梱の fal 動画生成プロバイダーのデフォルトは fal/fal-ai/minimax/video-01-live です。

機能	値
モード	テキストから動画、単一画像参照、Seedance 参照から動画
ランタイム	長時間実行ジョブ向けのキューベースの送信/ステータス/結果フロー

Available video models

HeyGen video-agent:

Seedance 2.0:

Seedance 2.0 config example

json5

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

Seedance 2.0 reference-to-video config example

json5

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

Reference-to-video は、共有の video_generate の images、videos、audioRefs パラメーターを通じて、最大 9 個の画像、3 個の動画、3 個の音声参照を受け付け、参照ファイルは合計で最大 12 個です。

HeyGen video-agent config example

json5

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