# Runway

> OpenClaw 中的 Runway 视频生成设置

- 网址：https://funcoding.ai/agents/openclaw/providers/runway/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/providers/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**

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

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

```bash
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` |

<div class="callout callout-warning">

视频生成视频目前要求使用 `runway/gen4_aleph`。其他 Runway 模型 ID 会拒绝视频参考输入。

</div>

<div class="callout callout-note">

如果从错误的列中选择 Runway 模型 ID，系统会在 API 请求离开 OpenClaw 之前返回明确错误。该提供商会在 `extensions/runway/video-generation-provider.ts` 中根据相应模式的允许列表（`TEXT_ONLY_MODELS`、`IMAGE_MODELS`、`VIDEO_MODELS`）验证 `model`。

</div>

## 配置

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

## 高级配置

<details>
<summary>环境变量别名</summary>

OpenClaw 同时识别 `RUNWAYML_API_SECRET`（规范名称）和 `RUNWAY_API_KEY`。
任一变量均可用于对 Runway 提供商进行身份验证。

</details>

<details>
<summary>任务轮询</summary>

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

</details>

## 相关内容

- [视频生成](https://funcoding.ai/agents/openclaw/tools/video-generation/)：通用工具参数、提供商选择和异步行为。
- [配置参考](https://funcoding.ai/agents/openclaw/gateway/config-agents/#agent-defaults)：智能体默认设置，包括视频生成模型。