​

動画生成

• 参照メディアなしのテキストから動画へのリクエストには generate
• リクエストに 1 つ以上の参照画像が含まれる場合は imageToVideo
• リクエストに 1 つ以上の参照動画が含まれる場合は videoToVideo

​

クイックスタート

1. サポートされている任意のプロバイダーの API キーを設定します。

export GEMINI_API_KEY="your-key"

2. 必要に応じてデフォルトモデルを固定します。

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

3. エージェントに依頼します。

夕焼けの中、親しみやすいロブスターがサーフィンしている 5 秒間のシネマティックな動画を生成してください。

​

動画を生成すると何が起こるか

1. OpenClaw はリクエストをプロバイダーに送信し、すぐにタスク ID を返します。
2. プロバイダーはバックグラウンドでジョブを処理します（通常は、プロバイダーと解像度に応じて 30 秒から 5 分）。
3. 動画の準備ができると、OpenClaw は内部完了イベントで同じセッションを再開します。
4. エージェントは完成した動画を元の会話に投稿します。

​

タスクライフサイクル

1. queued — タスクが作成され、プロバイダーが受け付けるのを待機中。
2. running — プロバイダーが処理中（通常は、プロバイダーと解像度に応じて 30 秒から 5 分）。
3. succeeded — 動画の準備完了。エージェントが再開し、会話に投稿。
4. failed — プロバイダーエラーまたはタイムアウト。エージェントがエラー詳細付きで再開。

openclaw tasks list
openclaw tasks show <taskId>
openclaw tasks cancel <taskId>

​

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

​

宣言された機能マトリクス

​

ツールパラメーター

​

必須

​

コンテンツ入力

​

スタイル制御

​

高度な設定

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

​

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

• アクティブな候補が maxInputAudios を宣言していない（または 0 として宣言している）場合、リクエストに音声参照が含まれているとその候補はスキップされ、 次の候補が試されます。
• アクティブな候補の maxDurationSeconds が要求された durationSeconds を下回っており、かつその候補が supportedDurationSeconds リストを宣言していない場合、その候補はスキップされます。
• リクエストに providerOptions が含まれており、アクティブな候補が 型付き providerOptions スキーマを明示的に宣言している場合、 指定されたキーがスキーマに存在しない、または値の型が一致しないと、 その候補はスキップされます。まだスキーマを宣言していないプロバイダーには、 オプションがそのまま渡されます（後方互換のパススルー）。 プロバイダーは空スキーマ （capabilities.providerOptions: {}）を宣言することで、すべての provider option を 明示的に拒否できます。この場合も型不一致と同様にスキップされます。

​

アクション

• generate（デフォルト） — 指定されたプロンプトと任意の参照入力から動画を作成します。
• status — 現在のセッションで進行中の動画タスクの状態を確認します。新しい生成は開始しません。
• list — 利用可能なプロバイダー、モデル、およびその機能を表示します。

​

モデル選択

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

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "google/veo-3.1-fast-generate-preview",
        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],
      },
    },
  },
}

​

プロバイダーメモ

​

プロバイダー機能モード

capabilities: {
  generate: {
    maxVideos: 1,
    maxDurationSeconds: 10,
    supportsResolution: true,
  },
  imageToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputImages: 1,
    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

• スイープ内のすべての非 FAL プロバイダーに対する generate
• 1 秒のロブスタープロンプト
• OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS （デフォルト 180000）によるプロバイダーごとの操作上限

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

• capabilities.imageToVideo.enabled の場合は imageToVideo
• capabilities.videoToVideo.enabled であり、かつプロバイダー/モデルが 共有スイープでバッファ支援のローカル動画入力を受け付ける場合は videoToVideo

• runway（runway/gen4_aleph を選択した場合のみ）

​

設定

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

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

​

関連

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