Providers
Fal
OpenClaw には、ホスト型の画像生成と動画生成向けに、バンドルされた fal provider が含まれています。
| Property | Value |
|---|---|
| Provider | fal |
| Auth | FAL_KEY（正式。FAL_API_KEY もフォールバックとして動作） |
| API | fal model endpoint |
はじめに
API キーを設定する
openclaw onboard --auth-choice fal-api-key
デフォルトの画像 model を設定する
{
agents: {
defaults: {
imageGenerationModel: {
primary: "fal/fal-ai/flux/dev",
},
},
},
}
画像生成
バンドルされた fal の画像生成 provider のデフォルトは
fal/fal-ai/flux/dev です。
| Capability | Value |
|---|---|
| Max images | リクエストごとに最大 4 枚 |
| Edit mode | 有効、参照画像は 1 枚 |
| Size overrides | サポートあり |
| Aspect ratio | サポートあり |
| Resolution | サポートあり |
| Output format | png または jpeg |
PNG 出力が必要な場合は outputFormat: "png" を使用してください。fal では
OpenClaw 内で明示的な透明背景の制御を宣言していないため、background: "transparent" は fal model では無視される override として報告されます。
fal をデフォルトの画像 provider として使うには:
{
agents: {
defaults: {
imageGenerationModel: {
primary: "fal/fal-ai/flux/dev",
},
},
},
}
動画生成
バンドルされた fal の動画生成 provider のデフォルトは
fal/fal-ai/minimax/video-01-live です。
| Capability | Value |
|---|---|
| Modes | テキストから動画、単一画像参照、Seedance の参照から動画 |
| Runtime | 長時間実行ジョブ向けの、キューを使った submit/status/result フロー |
利用可能な動画 model
HeyGen video-agent:
fal/fal-ai/heygen/v2/video-agent
Seedance 2.0:
fal/bytedance/seedance-2.0/fast/text-to-videofal/bytedance/seedance-2.0/fast/image-to-videofal/bytedance/seedance-2.0/fast/reference-to-videofal/bytedance/seedance-2.0/text-to-videofal/bytedance/seedance-2.0/image-to-videofal/bytedance/seedance-2.0/reference-to-video
Seedance 2.0 の設定例
{
agents: {
defaults: {
videoGenerationModel: {
primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
},
},
},
}
Seedance 2.0 の reference-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 件です。
HeyGen video-agent の設定例
{
agents: {
defaults: {
videoGenerationModel: {
primary: "fal/fal-ai/heygen/v2/video-agent",
},
},
},
}