moltbot/docs/providers/runway.md

title, summary, read_when

title	summary	read_when
Runway	Runway video generation setup in OpenClaw	You want to use Runway video generation in OpenClaw You need the Runway API key/env setup You want to make Runway the default video provider

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

```bash openclaw onboard --auth-choice runway-api-key ``` ```bash openclaw config set agents.defaults.videoGenerationModel.primary "runway/gen4.5" ``` 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

Local image and video references are supported via data URIs. Text-only runs currently expose `16:9` and `9:16` aspect ratios. Video-to-video currently requires `runway/gen4_aleph` specifically.

Configuration

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

Advanced notes

OpenClaw recognizes both `RUNWAYML_API_SECRET` (canonical) and `RUNWAY_API_KEY`. Either variable will authenticate the Runway provider. 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.

Related

Shared tool parameters, provider selection, and async behavior. Agent default settings including video generation model.