Skip to main content
OpenClaw 附带了一个用于托管视频生成的 runway 提供商。该插件默认启用，并将 runway 提供商注册到 videoGenerationProviders 合约中。
属性值
提供商 idrunway
插件捆绑内置，enabledByDefault: true
认证环境变量RUNWAYML_API_SECRET（规范）或 RUNWAY_API_KEY
入门标志--auth-choice runway-api-key
直接 CLI 标志--runway-api-key <key>
APIRunway 基于任务的视频生成（轮询 GET /v1/tasks/{id}）
默认模型runway/gen4.5

​
开始使用

1

设置 API 密钥

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

将 Runway 设置为默认视频提供商

openclaw config set agents.defaults.videoGenerationModel.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、veo31 张本地或远程图像
视频到视频gen4_aleph1 个本地或远程视频
支持通过 data 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 之前产生明确错误。该提供商会根据模式的允许列表（TEXT_ONLY_MODELS、IMAGE_MODELS、VIDEO_MODELS）在 extensions/runway/video-generation-provider.ts 中验证 model。

​
配置

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

​
高级配置

OpenClaw 同时识别 RUNWAYML_API_SECRET（规范）和 RUNWAY_API_KEY。 任一变量都可用于对 Runway 提供商进行身份验证。
Runway 使用基于任务的 API。提交生成请求后，OpenClaw 会轮询 GET /v1/tasks/{id}，直到视频准备就绪。轮询行为无需额外 配置。

​
相关内容

视频生成

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

配置参考

包括视频生成模型在内的代理默认设置。