Providers

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`

開始使用

bash

openclaw onboard --auth-choice runway-api-key

bash

openclaw config set agents.defaults.mediaModels.video.primary "runway/gen4.5"

要求代理程式生成影片。系統會自動使用 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`

json5

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

環境變數別名

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

工作輪詢

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