メインコンテンツへスキップ
OpenClawには、ホスト型の画像、動画、音楽生成向けにバンドル済みのfalプロバイダーが同梱されています。
プロパティ値
プロバイダーfal
認証FAL_KEY（標準。FAL_API_KEYもフォールバックとして動作）
APIfalモデルエンドポイント（https://fal.run。動画ジョブはhttps://queue.fal.runを使用）
ベースURLmodels.providers.fal.baseUrlで上書き

​
はじめに

1

Set the API key

openclaw onboard --auth-choice fal-api-key
非対話セットアップでは--fal-api-key <key>を渡すか、FAL_KEYをエクスポートできます。 オンボーディングでは、何も設定されていない場合にfal/fal-ai/flux/devもデフォルトの画像モデルとして設定します。
2

Set a default image model

{
  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 image-to-imageを除くすべてでサポート
解像度1K, 2K, 4K（モデルごとの制限は下記）
出力形式png（デフォルト）またはjpeg。Krea 2はoutputFormatの上書きを拒否
編集リクエスト（共有のimage / imagesパラメーター経由の参照画像）は、モデルごとの参照上限を持つモデル別の編集エンドポイントにルーティングされます。
モデルファミリーfal/以降のモデルref編集エンドポイント最大参照画像数
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 image-to-imageリクエストは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は、Fluxで使う汎用のimage_size / 編集エンドポイント用ペイロードの代わりに、aspect_ratio、creativity、image_style_referencesを送信します。モデルrefは次のとおりです。
  • 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を使用します。
機能値
モードText-to-video、単一画像参照、Seedance reference-to-video
ランタイム長時間実行ジョブ向けのキュー利用の送信/ステータス/結果フロー
タイムアウトデフォルトでジョブあたり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",
      },
    },
  },
}
Reference-to-videoは、共有のvideo_generateのimages、videos、audioRefsパラメーターを通じて、最大9枚の画像、3本の動画、3件の音声参照を受け付け、参照ファイルは合計で最大12件までです。音声参照には、同じリクエスト内に少なくとも1つの画像または動画参照が必要です。
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/fal-ai/heygen/v2/video-agent",
      },
    },
  },
}

​
音楽生成

バンドル済みのfal Pluginは、共有の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はprompt-to-audioエンドポイントです。これらのモデルファミリーを使いたい場合は、model上書きで選択してください。ACE-Stepは明示的な歌詞を拒否します。Stable Audioは歌詞とインストゥルメンタルモードの両方を拒否します。
上記の表とアコーディオンは、バンドル済みfalプロバイダーが特別扱いするモデルファミリーを対象としています。その他のfal画像エンドポイントIDも画像モデルとして選択できます。それらはFluxと同様に扱われます（汎用image_sizeペイロード、/image-to-image経由の参照画像1枚）。

​
関連

Image generation

共有画像ツールのパラメーターとプロバイダー選択。

Video generation

共有動画ツールのパラメーターとプロバイダー選択。

Music generation

共有音楽ツールのパラメーターとプロバイダー選択。

Configuration reference

画像、動画、音楽モデル選択を含むエージェントのデフォルト。