快速开始

跑道

OpenClaw 随附一个内置的 runway 提供商，用于托管式视频生成，默认启用，并注册到 videoGenerationProviders 合约。

属性	值
提供商 id	`runway`
插件	内置，`enabledByDefault: true`
凭证环境变量	`RUNWAYML_API_SECRET`（规范）或 `RUNWAY_API_KEY`
新手引导标志	`--auth-choice runway-api-key`
直接 CLI 标志	`--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.videoGenerationModel.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 个本地或远程视频

通过 data 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}，直到视频准备就绪。该轮询行为不需要额外配置。