Runway

OpenClaw 隨附內建的 runway 供應商，用於託管式影片生成。此供應商預設啟用，並依 videoGenerationProviders 合約註冊。

屬性	值
供應商 ID	runway
外掛	內建，enabledByDefault: true
驗證環境變數	RUNWAYML_API_SECRET（標準）或 RUNWAY_API_KEY
初始設定旗標	--auth-choice runway-api-key
直接命令列旗標	--runway-api-key <key>
API	Runway 工作型影片生成（GET /v1/tasks/{id} 輪詢）
預設模型	runway/gen4.5

​

開始使用

1. 設定 API 金鑰

   openclaw onboard --auth-choice runway-api-key
   
2. 將 Runway 設為預設影片供應商

   openclaw config set agents.defaults.mediaModels.video.primary "runway/gen4.5"
   
3. 生成影片

   要求代理程式生成影片。系統會自動使用 Runway。

​

支援的模式與模型

此供應商提供七個 Runway 模型，分為三種模式。同一個模型 ID 可用於多種模式（例如 gen4.5 同時適用於文字轉影片和圖片轉影片）。

模式	模型	參考輸入
文字轉影片	gen4.5（預設）、veo3.1、veo3.1_fast、veo3	無
圖片轉影片	gen4.5、gen4_turbo、gen3a_turbo、veo3.1、veo3.1_fast、veo3	1 張本機或遠端圖片
影片轉影片	gen4_aleph	1 部本機或遠端影片

本機圖片和影片參考可透過資料 URI 使用。

長寬比	允許的值
文字轉影片	16:9、9:16
圖片與影片編輯	1:1、16:9、9:16、3:4、4:3、21:9

影片轉影片目前需要 runway/gen4_aleph。其他 Runway 模型 ID 會拒絕影片參考輸入。

從錯誤的欄中選取 Runway 模型 ID，會在 API 請求離開 OpenClaw 前產生明確錯誤。供應商會在 extensions/runway/video-generation-provider.ts 中，依模式的允許清單（TEXT_ONLY_MODELS、IMAGE_MODELS、VIDEO_MODELS）驗證 model。

​

設定

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "runway/gen4.5",
      },
    },
  },
}

​

進階設定

環境變數別名

OpenClaw 可辨識 RUNWAYML_API_SECRET（標準）和 RUNWAY_API_KEY。 任一變數皆可用於驗證 Runway 供應商。

工作輪詢

Runway 使用工作型 API。提交生成請求後，OpenClaw 會輪詢 GET /v1/tasks/{id}，直到影片準備就緒。輪詢行為不需要 任何額外設定。

​

相關內容

影片生成

共用工具參數、供應商選擇及非同步行為。

設定參考

代理程式預設設定，包括影片生成模型。