Runway
OpenClaw ships a bundled runway provider for hosted video generation.
| Property | Value |
|---|---|
| Provider id | runway |
| Auth | RUNWAYML_API_SECRET (canonical) or RUNWAY_API_KEY |
| API | Runway task-based video generation (GET /v1/tasks/{id} polling) |
Getting started
- Set the API key
openclaw onboard --auth-choice runway-api-key - Set Runway as the default video provider
openclaw config set agents.defaults.videoGenerationModel.primary "runway/gen4.5" - Generate a video
Ask the agent to generate a video. Runway will be used automatically.
Supported modes
| Mode | Model | Reference input |
|---|---|---|
| Text-to-video | gen4.5 (default) | None |
| Image-to-video | gen4.5 | 1 local or remote image |
| Video-to-video | gen4_aleph | 1 local or remote video |
NOTE
Local image and video references are supported via data URIs. Text-only runs
currently expose 16:9 and 9:16 aspect ratios.
WARNING
Video-to-video currently requires runway/gen4_aleph specifically.
Configuration
{
agents: {
defaults: {
videoGenerationModel: {
primary: "runway/gen4.5",
},
},
},
}
Advanced notes
Environment variable aliases
OpenClaw recognizes both RUNWAYML_API_SECRET (canonical) and RUNWAY_API_KEY.
Either variable will authenticate the Runway provider.
Task polling
Runway uses a task-based API. After submitting a generation request, OpenClaw
polls GET /v1/tasks/{id} until the video is ready. No additional
configuration is needed for the polling behavior.