Runway
OpenClaw 中的 Runway 视频生成设置
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 |
入门指南
设置 API key
openclaw onboard --auth-choice runway-api-key将 Runway 设置为默认视频提供商
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 |
视频生成视频目前要求使用 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}，直到视频准备就绪。轮询行为
无需额外配置。