Runway

OpenClaw には、ホスト型動画生成用の runway プロバイダーが同梱されています。これはデフォルトで有効になっており、videoGenerationProviders コントラクトに登録されています。

プロパティ	値
プロバイダー ID	`runway`
Plugin	同梱、`enabledByDefault: true`
認証環境変数	`RUNWAYML_API_SECRET`（標準）または `RUNWAY_API_KEY`
オンボーディングフラグ	`--auth-choice runway-api-key`
CLI 直接指定フラグ	`--runway-api-key <key>`
API	Runway のタスクベース動画生成（`GET /v1/tasks/{id}` ポーリング）
デフォルトモデル	`runway/gen4.5`

はじめに

API キーを設定する

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

Runway をデフォルトの動画プロバイダーに設定する

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

動画を生成する

エージェントに動画の生成を依頼します。Runway が自動的に使用されます。

対応するモードとモデル

このプロバイダーは、3 つのモードに分類された 7 つの Runway モデルを公開します。同じモデル ID が複数のモードに対応する場合があります（たとえば、gen4.5 はテキストから動画への変換と画像から動画への変換の両方で使用できます）。

モード	モデル	参照入力
テキストから動画	`gen4.5`（デフォルト）、`veo3.1`、`veo3.1_fast`、`veo3`	なし
画像から動画	`gen4.5`、`gen4_turbo`、`gen3a_turbo`、`veo3.1`、`veo3.1_fast`、`veo3`	ローカルまたはリモート画像 1 枚
動画から動画	`gen4_aleph`	ローカルまたはリモート動画 1 本

ローカルの画像および動画の参照は、データ URI 経由でサポートされます。

アスペクト比	使用可能な値
テキストから動画	`16:9`、`9:16`
画像および動画の編集	`1:1`、`16:9`、`9:16`、`3:4`、`4:3`、`21:9`

現在、動画から動画への変換には runway/gen4_aleph が必要です。ほかの Runway モデル ID では、動画の参照入力が拒否されます。

誤った列から Runway モデル ID を選択すると、API リクエストが OpenClaw から送信される前に明示的なエラーが発生します。プロバイダーは extensions/runway/video-generation-provider.ts で、model をモードの許可リスト（TEXT_ONLY_MODELS、IMAGE_MODELS、VIDEO_MODELS）に照らして検証します。

設定

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

詳細設定

環境変数のエイリアス

OpenClaw は RUNWAYML_API_SECRET（標準）と RUNWAY_API_KEY の両方を認識します。どちらの変数でも Runway プロバイダーを認証できます。

タスクのポーリング

Runway はタスクベースの API を使用します。生成リクエストを送信した後、OpenClaw は動画の準備が完了するまで GET /v1/tasks/{id} をポーリングします。このポーリング動作に追加の設定は必要ありません。

動画生成

共通のツールパラメーター、プロバイダーの選択、非同期動作。

設定リファレンス

動画生成モデルを含む、エージェントのデフォルト設定。

Overview

Concepts and configuration

Providers

はじめに

対応するモードとモデル

設定

詳細設定

関連情報

動画生成

設定リファレンス

​はじめに

​対応するモードとモデル

​設定

​詳細設定

​関連情報

動画生成

設定リファレンス

はじめに

対応するモードとモデル

設定

詳細設定

関連情報