Files
openclaw/docs/providers/runway.md
Vincent Koc 6aaf235aee docs(providers): rewrite GLM, Runway, and Vydra with code-verified setup
GLM (docs/providers/glm.md): rewrote against extensions/zai/openclaw.plugin.json.
Removed the duplicate '# GLM models' H1 (Mintlify renders title from
frontmatter; an in-body H1 produces a brittle anchor). Replaced the
two-column model table with a single Notes column covering all 13
bundled refs, including which are reasoning, which accept image input,
and which is the default image model (zai/glm-4.6v from the auto-routing
defaults). Expanded the auth-choice step into a CodeGroup covering all
five onboarding choices (zai-api-key, zai-coding-global, zai-coding-cn,
zai-global, zai-cn) sourced from the plugin manifest's
providerAuthChoices.

Runway (docs/providers/runway.md): expanded the supported-modes table
to cover all seven Runway models from
extensions/runway/video-generation-provider.ts. Text-to-video now lists
veo3, veo3.1, veo3.1_fast alongside gen4.5; image-to-video adds
gen4_turbo, gen3a_turbo, veo3, veo3.1, and veo3.1_fast. Added an
aspect-ratio table covering the documented RUNWAY_TEXT_ASPECT_RATIOS
('16:9'/'9:16') and RUNWAY_EDIT_ASPECT_RATIOS ('1:1'/'16:9'/'9:16'/
'3:4'/'4:3'/'21:9'). Promoted the existing properties table with
plugin/onboarding/CLI flag rows from the manifest.

Vydra (docs/providers/vydra.md): added a properties table sourced from
extensions/vydra/openclaw.plugin.json, including the three
providerAuthContract memberships (image/video/speech) and the
vydra-api-key onboarding choice plus --vydra-api-key direct flag. Kept
the existing Warning about the apex-host redirect intact.
2026-05-05 17:15:52 -07:00

4.2 KiB

summary, title, read_when
summary title read_when
Runway video generation setup in OpenClaw Runway
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

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

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 and models

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
Video-to-video currently requires `runway/gen4_aleph`. Other Runway model ids reject video reference inputs. Picking a Runway model id from the wrong column produces an explicit error before the API request leaves OpenClaw. The provider validates `model` against the mode's allowlist (`TEXT_ONLY_MODELS`, `IMAGE_MODELS`, `VIDEO_MODELS`) in `extensions/runway/video-generation-provider.ts`.

Configuration

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

Advanced configuration

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. Shared tool parameters, provider selection, and async behavior. Agent default settings including video generation model.