動画生成

"status" は現在のセッションタスクを返します。"list" はプロバイダーを検査します。

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg 任意のプロバイダー操作タイムアウト (ミリ秒)。省略した場合、OpenClaw は設定済みであれば agents.defaults.videoGenerationModel.timeoutMs を使用し、そうでなければ存在する場合に Plugin 作成のプロバイダーデフォルトを使用します。 OPENCLAW_DOCS_MARKER:paramClose:

参照入力はランタイムモードを選択します。

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

画像参照と動画参照の混在は、安定した共通機能サーフェスではありません。 リクエストごとに 1 種類の参照タイプを使用することを推奨します。

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

一部の機能チェックはツール境界ではなくフォールバック層で適用されるため、 プライマリプロバイダーの制限を超えるリクエストでも、対応可能なフォールバックで 実行できる場合があります。

• アクティブ候補が maxInputAudios を宣言していない (または 0) 場合、 リクエストに音声参照が含まれているとスキップされ、次の候補が試行されます。同じ ガードは、画像および動画参照数に対して maxInputImages/maxInputVideos にも適用されます。
• アクティブ候補の maxDurationSeconds が要求された durationSeconds を下回り、 宣言済みの supportedDurationSeconds リストがない場合 -> スキップされます。
• リクエストに providerOptions が含まれ、アクティブ候補が型付き providerOptions スキーマを明示的に宣言している場合 -> 指定されたキーが スキーマ内にない、または値の型が一致しない場合はスキップされます。宣言済み スキーマのないプロバイダーはオプションをそのまま受け取ります (後方互換の パススルー)。プロバイダーは空のスキーマ (capabilities.providerOptions: {}) を 宣言することで、すべてのプロバイダーオプションを拒否できます。この場合、 型不一致と同じスキップが発生します。

リクエスト内の最初のスキップ理由は warn でログ出力されるため、オペレーターは プライマリプロバイダーが見送られたことを把握できます。以降のスキップは debug で ログ出力され、長いフォールバックチェーンが静かに保たれます。すべての候補が スキップされた場合、集約エラーには各候補のスキップ理由が含まれます。

アクション

モデル選択

OpenClaw は次の順序でモデルを解決します。

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

プロバイダーが失敗した場合、次の候補が自動的に試行されます。すべての 候補が失敗した場合、エラーには各試行の詳細が含まれます。

明示的な model、primary、fallbacks エントリのみを使用するには、 agents.defaults.mediaGenerationAutoProviderFallback: false を設定します。

{  agents: {    defaults: {      videoGenerationModel: {        primary: "google/veo-3.1-fast-generate-preview",        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],        timeoutMs: 180000, // optional per-tool provider request timeout override      },    },  },}

プロバイダーノート

プロバイダー機能モード

共有動画生成コントラクトは、フラットな集約制限だけでなく、モード固有の機能をサポートします。新しいプロバイダー実装では、明示的なモードブロックを優先してください。

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,  },}

maxInputImages や maxInputVideos などのフラットな集約フィールドは、変換モードのサポートを公表するには不十分です。プロバイダーは generate、imageToVideo、videoToVideo を明示的に宣言し、ライブテスト、コントラクトテスト、共有 video_generate ツールがモードサポートを決定的に検証できるようにする必要があります。

プロバイダー内の 1 つのモデルが他より広い参照入力サポートを持つ場合は、モード全体の制限を引き上げる代わりに、maxInputImagesByModel、maxInputVideosByModel、または maxInputAudiosByModel を使用してください。

ライブテスト

共有バンドルプロバイダー向けのオプトインのライブカバレッジ:

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）から取得するプロバイダーごとの操作上限。

FAL はオプトインです。プロバイダー側のキュー待ち時間がリリース時間を支配する可能性があるためです。

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

OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1 を設定すると、共有スイープがローカルメディアで安全に実行できる宣言済み変換モードも実行されます。

• capabilities.imageToVideo.enabled の場合の imageToVideo。
• capabilities.videoToVideo.enabled で、プロバイダー/モデルが共有スイープ内のバッファ backed ローカル動画入力を受け付ける場合の videoToVideo。

現在、共有 videoToVideo ライブレーンは、runway/gen4_aleph を選択した場合にのみ runway をカバーします。

設定

OpenClaw 設定でデフォルトの動画生成モデルを設定します。

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

または CLI 経由:

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