docs/providers/runway.md
OpenClaw ships a bundled runway provider for hosted video generation. The plugin is enabled by default and registers the runway provider against the videoGenerationProviders contract.
| Property | Value |
|---|---|
| Provider id | runway |
| Plugin | bundled, enabledByDefault: true |
| Auth env vars | RUNWAYML_API_SECRET (canonical) or RUNWAY_API_KEY |
| Onboarding flag | --auth-choice runway-api-key |
| Direct CLI flag | --runway-api-key <key> |
| API | Runway task-based video generation (GET /v1/tasks/{id} polling) |
| Default model | runway/gen4.5 |
The provider exposes seven Runway models split across three modes. The same model id can serve more than one mode (for example gen4.5 works for both text-to-video and image-to-video).
| Mode | Models | Reference input |
|---|---|---|
| Text-to-video | gen4.5 (default), veo3.1, veo3.1_fast, veo3 | None |
| Image-to-video | gen4.5, gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast, veo3 | 1 local or remote image |
| Video-to-video | gen4_aleph | 1 local or remote video |
Local image and video references are supported via data URIs.
| Aspect ratios | Allowed values |
|---|---|
| Text-to-video | 16:9, 9:16 |
| Image and video edits | 1:1, 16:9, 9:16, 3:4, 4:3, 21:9 |
{
agents: {
defaults: {
videoGenerationModel: {
primary: "runway/gen4.5",
},
},
},
}