OpenClawでfalプロバイダーを統合：画像・動画生成を高速実装

画像や動画の生成AIをアプリケーションに組み込もうとすると、APIのセットアップやモデルの管理が意外と面倒に感じることがありますよね。OpenClawなら、fal プロバイダーが最初から組み込まれているので、ホスト型の画像・動画生成をスムーズに開始できます。

fal

OpenClawには、画像や動画の生成を行うための fal プロバイダーが同梱されています。

• Provider: fal
• Auth: FAL_KEY（推奨。FAL_API_KEY もフォールバックとして利用可能です）
• API: fal モデルエンドポイント

クイックスタート

まずは、以下の手順でセットアップを進めましょう。

1. APIキーを設定します：

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

2. デフォルトの画像モデルを設定します：

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

画像生成

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

• 生成：1リクエストにつき最大4枚まで
• 編集モード：有効（参照画像1枚）
• size、aspectRatio、resolution をサポート
• 編集時の注意点：現在の fal 画像編集エンドポイントは aspectRatio の上書きをサポートしていません。

fal をデフォルトの画像プロバイダーとして使用する場合の設定例です：

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

動画生成

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

• モード：text-to-video および単一画像参照フロー
• 実行環境：長時間実行ジョブのためのキューベース（送信/ステータス確認/結果取得）フロー
• 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/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