影片生成

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

• 沒有參考媒體 → 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

Repo 包裝器：

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。

目前共用的 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