> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

## 开始使用

<Steps>
  <Step title="设置 API 密钥">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --auth-choice runway-api-key
    ```
  </Step>

  <Step title="将 Runway 设置为默认视频提供商">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw config set agents.defaults.mediaModels.video.primary "runway/gen4.5"
    ```
  </Step>

  <Step title="生成视频">
    让代理生成一个视频。Runway 将会自动使用。
  </Step>
</Steps>

## 支持的模式和模型

此提供商在三种模式下提供七个 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 将拒绝视频参考输入。
</Warning>

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

## 配置

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      mediaModels: {
        video: {
          primary: "runway/gen4.5",
        },
      },
    },
  },
}
```

## 高级配置

<AccordionGroup>
  <Accordion title="环境变量别名">
    OpenClaw 同时识别 `RUNWAYML_API_SECRET`（规范名称）和 `RUNWAY_API_KEY`。
    任意一个变量都可用于验证 Runway 提供方。
  </Accordion>

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

## 相关内容

<CardGroup cols={2}>
  <Card title="视频生成" href="/tools/video-generation" icon="video">
    共享工具参数、提供商选择和异步行为。
  </Card>

  <Card title="配置参考" href="/gateway/config-agents#agent-defaults" icon="gear">
    Agent 默认设置，包括 `mediaModels.video`。
  </Card>
</CardGroup>