openclaw/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.

• Provider id: runway
• Auth: RUNWAYML_API_SECRET (canonical) or RUNWAY_API_KEY
• API: Runway task-based video generation (GET /v1/tasks/{id} polling)

Quick start

1. Set the API key:

openclaw onboard --auth-choice runway-api-key

2. Set Runway as the default video provider:

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

3. 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.
• Video-to-video currently requires runway/gen4_aleph specifically.
• Text-only runs currently expose 16:9 and 9:16 aspect ratios.

Configuration

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

Related

• Video Generation -- shared tool parameters, provider selection, and async behavior
• Configuration Reference