在 OpenClaw 中使用 Runway 视频生成，需要先设置 API 密钥（RUNWAYML_API_SECRET 或 RUNWAY_API_KEY）并配置默认模型为 runway/gen4.5。Runway 提供文生视频、图生视频（支持 6 个模型）和视频转视频（仅 runway/gen4_aleph）三种模式，模型 ID 错误会在请求发出前报错。无需额外配置即可自动轮询任务状态。

OpenClaw Runway 配置：API 密钥、模型选择与故障排除

OpenClaw 内置 runway Provider，默认启用，在 videoGenerationProviders 合约下注册。

属性	值
Provider 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

怎么配置 Runway 视频生成

设置 API 密钥

```bash
openclaw onboard --auth-choice runway-api-key
```
也可以直接使用环境变量 `RUNWAYML_API_SECRET` 或 `RUNWAY_API_KEY`。

设置 Runway 为默认视频 Provider

```bash
openclaw config set agents.defaults.videoGenerationModel.primary "runway/gen4.5"
```

生成视频

向智能体发起视频生成请求，OpenClaw 会自动调用 Runway 生成。

支持的模式与模型

Runway Provider 公开 7 个模型，分布在三种模式下。同一个模型 ID 可能支持多种模式（例如 gen4.5 同时支持文生视频和图生视频）。

模式	模型	参考输入
文生视频（Text-to-video）	gen4.5（默认），veo3.1，veo3.1_fast，veo3	无
图生视频（Image-to-video）	gen4.5，gen4_turbo，gen3a_turbo，veo3.1，veo3.1_fast，veo3	1 张本地或远程图片
视频转视频（Video-to-video）	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 会拒绝视频引用输入。

INFO

如果选择错误的模型 ID（例如将文生视频模型用于图生视频），OpenClaw 会在发出 API 请求前立即报错。模型验证逻辑在 extensions/runway/video-generation-provider.ts 中的 TEXT_ONLY_MODELS、IMAGE_MODELS 和 VIDEO_MODELS 列表里检查。

配置示例

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

高级配置

环境变量别名

OpenClaw 同时识别 `RUNWAYML_API_SECRET`（规范名）和 `RUNWAY_API_KEY`。设置其中任何一个即可完成认证。

任务轮询机制

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

常见问题

设置默认模型后，智能体还是不用 Runway 生成视频怎么办？

检查配置是否生效：运行 openclaw config get agents.defaults.videoGenerationModel.primary 确认输出为 "runway/gen4.5"。同时确认环境变量 RUNWAYML_API_SECRET 或 RUNWAY_API_KEY 已正确设置且没有过期。如果仍有问题，使用 openclaw doctor 诊断 Provider 认证状态。

Runway 模型 ID 有哪些？怎么选？

文生视频：gen4.5（默认）、veo3.1、veo3.1_fast、veo3。图生视频额外支持 gen4_turbo、gen3a_turbo。视频转视频仅 gen4_aleph。选择模型时根据生成模式匹配表格，错误 ID 会在请求前被拒绝。

环境变量 RUNWAYML_API_SECRET 和 RUNWAY_API_KEY 有什么区别？

两者等价，任选其一。RUNWAYML_API_SECRET 是规范名，RUNWAY_API_KEY 是别名。建议优先使用 RUNWAYML_API_SECRET 以避免与其他工具的 RUNWAY_API_KEY 变量冲突。

延伸阅读

视频生成

共享工具参数、Provider 选择、异步行为。

配置参考

智能体默认设置，包括视频生成模型配置。