動画生成

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

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg 省略可能なプロバイダー操作のタイムアウト（ミリ秒）。省略した場合、OpenClaw は設定されていれば agents.defaults.mediaModels.video.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 が優先されます。

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

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

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

ライブテスト

共有の同梱プロバイダー向けのオプトイン式ライブカバレッジ：

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）。

プロバイダー側のキュー待ち時間がリリース所要時間の大部分を占める可能性があるため、 FAL はオプトインです。

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

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

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

現在、共有の videoToVideo ライブレーンで runway が対象になるのは、 runway/gen4_aleph を選択した場合のみです。

構成

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

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

または CLI を使用します。

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