Skip to main content
OpenClaw 随附一个内置的 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 key

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

​
相关内容

视频生成

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

配置参考

Agent 默认设置，包括视频生成模型。