Files
openclaw/docs/providers/runway.md
Peter Steinberger edecdbd05e refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527)
* refactor(config): consolidate media model lists

* refactor(config): unify memory configuration

* refactor(config): consolidate TTS ownership

* refactor(config): move typing policy to agents

* refactor(config): retire product-level config surfaces

* refactor(config): share scoped tool policy type

* chore(config): refresh generated baselines

* fix(config): honor agent typing overrides

* fix(config): migrate sibling config consumers

* refactor(infra): keep base64url decoder private

* fix(config): strip invalid legacy TTS values

* chore(config): refresh rebased baseline hash

* fix(doctor): route legacy messages.tts.realtime voice to talk during tts move

* refactor(config): polish final layout names

* refactor(config): freeze retired tuning defaults

* feat(config): add fast mode default symmetry

* refactor(config): key agent entries by id

* docs(config): update final layout reference

* test(config): cover final layout migrations

* chore(config): refresh final layout baselines

* fix(config): align final layout runtime readers

* fix(config): align remaining readers

* fix(config): stabilize final layout migrations

* fix(config): finalize config projection proof

* fix(config): address final layout review

* docs(release): preserve historical config names

* fix(config): complete keyed agent migration

* fix(config): close final migration gaps

* fix(config): finish full-branch review

* fix(config): complete runtime secret detection

* fix(config): close final review findings

* fix(config): finish canonical docs and heartbeat migration

* fix(config): integrate latest main after rebase

* refactor(env): isolate test-only controls

* refactor(env): isolate build and development controls

* refactor(env): collapse process identity indirection

* refactor(env): remove duplicate config and temp aliases

* docs(env): define the operator-facing allowlist

* ci(env): ratchet production variable count

* fix(env): remove stale provider helper import

* fix(env): make ratchet sorting explicit

* test(env): keep test seam in dead-code audit

* test(env): cover ratchet growth and boundary; document surface budgets

* docs(config): document tier-eval consolidations

* docs(config): clarify speech preference ownership

* test(memory): align retired tuning fixtures

* refactor(memory): freeze engine heuristics

* refactor(config): apply tier-eval tranche

* refactor(tts): move persona shaping to providers

* refactor(compaction): move prompt policy to providers

* test(config): align hookified prompt fixtures

* chore(deadcode): classify test-only exports

* chore(github): remove unused spawn helper

* chore(deadcode): classify queue diagnostics

* chore(deadcode): remove unused lane snapshot export

* chore(plugin-sdk): ratchet consolidated surface

* fix(config): integrate latest main after rebase
2026-07-21 20:28:43 -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, enabled by default, registered 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.mediaModels.video.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 authenticates 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.