跳转至

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

快速入门

1. 设置 API 密钥

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

2. 将 Runway 设置为默认视频提供程序

openclaw config set agents.defaults.mediaModels.video.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、veo3 1 张本地或远程图像
视频转视频 gen4_aleph 1 个本地或远程视频

支持通过 data URI 引用本地图像和视频。

宽高比 允许值
文本转视频 16:9, 9:16
图像和视频编辑 1:1, 16:9, 9:16, 3:4, 4:3, 21:9

Warning

视频转视频目前需要 runway/gen4_aleph。其他 Runway 模型 ID 会拒绝视频参考输入。

Note

从错误的列中选择 Runway 模型 ID 会在 API 请求离开 OpenClaw 之前产生明确的错误。该提供程序会在 extensions/runway/video-generation-provider.ts 中根据模式的允许列表（TEXT_ONLY_MODELS、IMAGE_MODELS、VIDEO_MODELS）验证 model。

配置

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

高级配置

环境变量别名

OpenClaw 同时识别 RUNWAYML_API_SECRET（标准）和 RUNWAY_API_KEY。 任一变量都能对 Runway 提供程序进行身份验证。

任务轮询

Runway 使用基于任务的 API。提交生成请求后，OpenClaw 会轮询 GET /v1/tasks/{id}，直到视频准备就绪。轮询行为 无需额外配置。

视频生成

共享工具参数、提供程序选择以及异步行为。

配置参考

代理默认设置，包括 mediaModels.video。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw