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

视频生成

通用工具参数、提供商选择和异步行为。

配置参考

智能体默认设置，包括视频生成模型。

概览

模型概念

提供商

入门指南

支持的模式和模型

配置

高级配置

相关内容

视频生成

配置参考

​入门指南

​支持的模式和模型

​配置

​高级配置

​相关内容

视频生成

配置参考

入门指南

支持的模式和模型

配置

高级配置

相关内容