影片生成

"status" 會傳回目前工作階段的任務；"list" 會檢查供應商。

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg 選填的供應商作業逾時時間（毫秒）。若省略，OpenClaw 會在已設定時使用 agents.defaults.mediaModels.video.timeoutMs，否則會使用外掛作者定義的供應商預設值（若有）。 OPENCLAW_DOCS_MARKER:paramClose:

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

• 無參考媒體 -> generate
• 有任何圖片參考 -> imageToVideo
• 有任何影片參考 -> videoToVideo
• 參考音訊輸入不會變更解析出的模式；它們會套用在 圖片／影片參考所選模式之上，且僅適用於 宣告 maxInputAudios 的供應商。

混合圖片與影片參考並非穩定的共用能力介面。 每個要求應優先只使用一種參考類型。

備援與型別化選項

部分能力檢查是在備援層而非工具 邊界套用，因此超過主要供應商限制的要求，仍可 由具備相應能力的備援供應商執行：

• 當要求包含音訊參考時，若作用中的候選項目未宣告 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 等扁平彙總欄位 不足以宣告轉換模式支援。供應商應 明確宣告 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

此即時測試檔預設會優先使用已匯出的供應商環境變數，而非已儲存的驗證 設定檔，並預設執行適合發布的冒煙測試：

• generate，套用於掃描中的每個非 FAL 供應商。
• 一秒鐘的龍蝦提示詞。
• 各供應商的操作上限取自 OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS（預設為 180000）。

FAL 採選擇性啟用，因為供應商端的佇列延遲可能會主導發布 時間：

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

設定 OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1，即可一併執行已宣告且共用掃描能以本機媒體安全測試的 轉換模式：

• imageToVideo，條件為 capabilities.imageToVideo.enabled。
• videoToVideo，條件為 capabilities.videoToVideo.enabled，且 供應商／模型在共用掃描中接受以緩衝區為基礎的本機影片輸入。

目前僅在選取 runway/gen4_aleph 時，共用 videoToVideo 即時測試通道才會涵蓋 runway。

設定

在 OpenClaw 設定中設定預設影片產生模型：

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

或透過命令列介面：

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