動画生成

"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, // ツールごとのプロバイダーリクエストタイムアウトを任意でオーバーライド      },    },  },}

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

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

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

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

このライブテストファイルでは、デフォルトで保存済み認証プロファイルよりも、 すでにエクスポートされているプロバイダー環境変数を優先し、リリース時に安全な スモークテストをデフォルトで実行します。

• 一連のテスト内にある 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 であり、かつプロバイダーまたはモデルが 共有テストでバッファーに格納されたローカル動画入力を受け付ける場合は 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