影片生成

"status" 回傳目前工作階段任務；"list" 檢查提供者。

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg 選用的提供者操作逾時，以毫秒為單位。省略時，若已設定，OpenClaw 會使用 agents.defaults.videoGenerationModel.timeoutMs。 OPENCLAW_DOCS_MARKER:paramClose:

參考輸入會選擇執行階段模式：

• 沒有參考媒體 → generate
• 任何圖片參考 → imageToVideo
• 任何影片參考 → videoToVideo
• 參考音訊輸入不會變更已解析模式；它們會套用在 圖片/影片參考所選模式之上，且只會在 宣告 maxInputAudios 的提供者上運作。

混用圖片與影片參考不是穩定的共用能力表面。 建議每個請求只使用一種參考類型。

備援與型別化選項

某些能力檢查會在備援層套用，而不是在 工具邊界套用，因此超出主要提供者限制的請求 仍可在具備能力的備援上執行：

• 當請求包含音訊參考時，宣告沒有 maxInputAudios（或 0）的作用中候選項會被略過； 接著嘗試下一個候選項。
• 作用中候選項的 maxDurationSeconds 低於請求的 durationSeconds， 且未宣告 supportedDurationSeconds 清單 → 略過。
• 請求包含 providerOptions，且作用中候選項明確 宣告型別化 providerOptions 結構描述 → 若提供的鍵 不在結構描述中，或值型別不相符，則略過。沒有 宣告結構描述的提供者會原樣接收選項（向後相容 透傳）。提供者可透過宣告空結構描述 （capabilities.providerOptions: {}）選擇退出所有提供者選項， 這會造成與型別不相符相同的略過。

請求中的第一個略過原因會以 warn 記錄，讓操作員看到 其主要提供者何時被跳過；後續略過會以 debug 記錄，以 避免冗長備援鏈過於吵雜。如果每個候選項都被略過， 彙總錯誤會包含每個項目的略過原因。

動作

模型選擇

OpenClaw 會依此順序解析模型：

1. model 工具參數 - 如果代理在呼叫中指定。
2. 設定中的 videoGenerationModel.primary。
3. 依序使用 videoGenerationModel.fallbacks。
4. 自動偵測 - 具有有效驗證的提供者，從 目前預設提供者開始，然後依字母順序處理其餘 提供者。

如果某個提供者失敗，會自動嘗試下一個候選項。如果所有 候選項都失敗，錯誤會包含每次嘗試的詳細資料。

設定 agents.defaults.mediaGenerationAutoProviderFallback: false，即可只使用 明確的 model、primary 和 fallbacks 項目。

{  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 這類扁平彙總欄位 不足以宣告支援轉換模式。提供者應 明確宣告 generate、imageToVideo 和 videoToVideo，讓即時 測試、合約測試和共用 video_generate 工具能以確定性方式驗證 模式支援。

當提供者中的某個模型具備比其餘模型更廣的參照輸入支援時， 請使用 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。
• 一秒鐘的龍蝦提示。
• 每個提供者的操作上限來自 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。

目前，只有在你選擇 runway/gen4_aleph 時，共用 videoToVideo 即時路徑才會涵蓋 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