動画生成

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

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg 任意のプロバイダー操作タイムアウト（ミリ秒）。省略した場合、OpenClaw は設定されていれば agents.defaults.videoGenerationModel.timeoutMs を使用します。 OPENCLAW_DOCS_MARKER:paramClose:

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

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

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

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

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

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

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

アクション

モデル選択

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

1. model ツールパラメーター - agent が呼び出しで指定した場合。
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"],      },    },  },}

プロバイダーの注意事項

プロバイダー機能モード

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

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

このライブファイルは、不足しているプロバイダー環境変数を ~/.profile から読み込み、デフォルトでは 保存済み認証プロファイルよりもライブ/環境 API キーを優先し、 デフォルトでリリースに安全なスモークを実行します。

• スイープ内のすべての非 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