動画生成

• generate - 参照メディアなし（テキストから動画）。
• imageToVideo - 1 つ以上の参照画像。
• videoToVideo - 1 つ以上の参照動画。

​

クイックスタート

export GEMINI_API_KEY="your-key"

openclaw config set agents.defaults.mediaModels.video.primary "google/veo-3.1-fast-generate-preview"

​

非同期生成の仕組み

1. OpenClaw はリクエストをプロバイダーに送信し、タスク ID を即座に返します。
2. プロバイダーはバックグラウンドでジョブを処理します（プロバイダーと解像度に応じて通常 30 秒から数分。キューを使用する低速なプロバイダーでは、設定されたタイムアウトまで実行される場合があります）。
3. 動画の準備が完了すると、OpenClaw は内部の完了イベントで同じセッションを起動します。
4. エージェントは、セッションの通常の可視返信モードを通じて報告します。 自動の最終返信、またはセッションでメッセージツールが必要な場合は message(action="send") です。 リクエスターのセッションが非アクティブである場合、またはその起動に失敗し、生成されたメディアが完了返信にも含まれていない場合、OpenClaw は メディアを含む冪等な直接フォールバックを送信します。

​

タスクのライフサイクル

openclaw tasks list
openclaw tasks show <lookup>
openclaw tasks cancel <lookup>

​

サポートされているプロバイダー

​

機能マトリックス

​

ツールパラメーター

​

必須

​

コンテンツ入力

​

スタイル制御

​

高度な設定

• 参照メディアなし -> generate
• 画像参照あり -> imageToVideo
• 動画参照あり -> videoToVideo
• 参照音声入力は、解決されたモードを変更しません。画像／動画参照によって 選択されたモードに追加で適用され、maxInputAudios を宣言する プロバイダーでのみ機能します。

​

フォールバックと型付きオプション

• 音声参照を含むリクエストで、アクティブな候補が maxInputAudios（または 0）を宣言していない場合、 その候補はスキップされ、次の候補が試されます。同じ ガードが、maxInputImages／maxInputVideos に対する画像および動画の参照数にも 適用されます。
• アクティブな候補の maxDurationSeconds が要求された durationSeconds を下回り、 supportedDurationSeconds リストも宣言されていない場合、その候補はスキップされます。
• リクエストに providerOptions が含まれ、アクティブな候補が型付き providerOptions スキーマを明示的に宣言している場合、指定されたキーが スキーマにないか、値の型が一致しなければスキップされます。スキーマを 宣言していないプロバイダーには、オプションがそのまま渡されます（後方互換性のある パススルー）。プロバイダーは空のスキーマ （capabilities.providerOptions: {}）を宣言することで、すべてのプロバイダーオプションを無効化できます。 この場合も、型の不一致と同様にスキップされます。

​

アクション

​

モデルの選択

1. model ツールパラメーター - エージェントが呼び出しで指定した場合。
2. 設定の videoGenerationModel.primary。
3. 順番に videoGenerationModel.fallbacks。
4. 自動検出 - 有効な認証を持つプロバイダー。現在の デフォルトプロバイダーから開始し、残りのプロバイダーをアルファベット順に 試します。

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "google/veo-3.1-fast-generate-preview",
        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],
        timeoutMs: 180000, // ツールごとのプロバイダーリクエストタイムアウトの省略可能なオーバーライド
      },
    },
  },
}

​

プロバイダーに関する注意事項

​

プロバイダーの機能モード

capabilities: {
  generate: {
    maxVideos: 1,
    maxDurationSeconds: 10,
    supportsResolution: true,
  },
  imageToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputImages: 1,
    maxInputImagesByModel: { "provider/reference-to-video": 9 },
    maxDurationSeconds: 5,
  },
  videoToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputVideos: 1,
    maxDurationSeconds: 5,
  },
}

​

ライブテスト

OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/video-generation-providers.live.test.ts

pnpm test:live:media video

• generate：スイープ内の FAL 以外の各プロバイダー。
• 1 秒の Lobster プロンプト。
• OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS によるプロバイダーごとの操作上限 （デフォルトは 180000）。

pnpm test:live:media video --video-providers fal

• capabilities.imageToVideo.enabled の場合は imageToVideo。
• capabilities.videoToVideo.enabled であり、共有スイープにおいて プロバイダーまたはモデルがバッファーを基盤とするローカル動画入力を受け付ける場合は videoToVideo。

​

構成

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "qwen/wan2.6-t2v",
        fallbacks: ["qwen/wan2.6-r2v-flash"],
      },
    },
  },
}

openclaw config set agents.defaults.mediaModels.video.primary "qwen/wan2.6-t2v"

​

関連項目

• Alibaba Model Studio
• バックグラウンドタスク - 非同期動画生成のタスク追跡
• BytePlus
• ComfyUI
• 構成リファレンス
• fal
• Google (Gemini)
• MiniMax
• モデル
• OpenAI
• Qwen
• Runway
• Together AI
• ツールの概要
• Vydra
• xAI