OpenRouter

OpenRouter は、1 つの API と 1 つのキーで多数のモデルにリクエストをルーティングします。 OpenAI 互換であるため、OpenClaw は他のプロキシプロバイダーで使用するものと同じ openai-completions 形式のトランスポートを介して通信します。

はじめに

openclaw onboard --auth-choice openrouter-oauth

openclaw models set openrouter/<provider>/<model>

openclaw onboard --auth-choice openrouter-api-key

openclaw models set openrouter/<provider>/<model>

設定例

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      model: { primary: "openrouter/auto" },    },  },}

モデル参照

ライブカタログの検出を利用できない場合に使用される組み込みのフォールバックモデル：

openrouter/openrouter/fusion（Fusion ルーターを参照）を含む、その他の openrouter/<provider>/<model> 参照は、OpenRouter のライブモデルカタログに対して 動的に解決されます。

画像生成

OpenRouter は image_generate ツールのバックエンドとして使用できます。 agents.defaults.mediaModels.image 配下に OpenRouter の画像モデルを設定します。

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      imageGenerationModel: {        primary: "openrouter/google/gemini-3.1-flash-image-preview",        timeoutMs: 180_000,      },    },  },}

OpenClaw は modalities: ["image", "text"] を指定して、OpenRouter の chat-completions 画像 API に 画像リクエストを送信します。Gemini 画像モデルには、OpenRouter の image_config を介して aspectRatio および resolution のヒントも渡されますが、他の 画像モデルには渡されません。低速なモデルには agents.defaults.mediaModels.image.timeoutMs を使用します。 ただし、image_generate ツールの呼び出しごとの timeoutMs が引き続き優先されます。

動画生成

OpenRouter は、非同期の /videos API を介して video_generate ツールのバックエンドとして使用できます。 agents.defaults.mediaModels.video 配下に OpenRouter の動画モデルを設定します。

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      videoGenerationModel: {        primary: "openrouter/google/veo-3.1-fast",      },    },  },}

OpenClaw はテキストから動画および画像から動画へのジョブを送信し、返された polling_url をポーリングして、完成した動画を OpenRouter の unsigned_urls またはジョブコンテンツのエンドポイントからダウンロードします。 参照画像はデフォルトで先頭／末尾フレーム画像として扱われ、reference_image と タグ付けされた画像は代わりに入力参照として送信されます。組み込みの google/veo-3.1-fast デフォルトは、4/6/8 秒の長さ、 720P／1080P の解像度、および 16:9／9:16 のアスペクト比をサポートします。 動画から動画への変換はサポートされていません。アップストリーム API が受け付けるのは テキストと画像の参照のみです。

音楽生成

OpenRouter は、chat-completions の音声出力を介して music_generate ツールのバックエンドとして使用できます。 agents.defaults.mediaModels.music 配下に OpenRouter の音声モデルを設定します。

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      musicGenerationModel: {        primary: "openrouter/google/lyria-3-pro-preview",        timeoutMs: 180_000,      },    },  },}

組み込みの OpenRouter 音楽プロバイダーのデフォルトは google/lyria-3-pro-preview で、 google/lyria-3-clip-preview も公開します。OpenClaw は modalities: ["text", "audio"] を送信し、 レスポンスをストリーミングして音声チャンクを収集し、その結果をチャンネル配信用の 生成メディアとして保存します。Lyria モデルは、共有の music_generate image=... パラメーターを介して 1 枚の参照画像を受け付けます。 ストリーミング音声、文字起こしの保持、および派生した SSE イベントエンベロープは、 agents.defaults.mediaMaxMb によって上限が設定されます（デフォルトの音声上限は 16 MB）。

テキスト読み上げ

OpenRouter は、OpenAI 互換の /audio/speech エンドポイントを介して TTS プロバイダーとして機能できます。

{  tts: {    auto: "always",    provider: "openrouter",    providers: {      openrouter: {        model: "hexgrad/kokoro-82m",        speakerVoice: "af_alloy",        responseFormat: "mp3",      },    },  },}

tts.providers.openrouter.apiKey を省略すると、TTS は models.providers.openrouter.apiKey、次に OPENROUTER_API_KEY へフォールバックします。

音声からテキストへの変換（受信音声）

OpenRouter は、共有の tools.media.audio パスから STT エンドポイント （/audio/transcriptions）を使用して、受信した音声／オーディオ添付ファイルを 文字起こしできます。これは、受信した音声／オーディオをメディア理解の事前処理へ 転送するすべてのチャンネル Plugin に適用されます。

{  tools: {    media: {      audio: {        enabled: true,        models: [{ provider: "openrouter", model: "openai/whisper-large-v3-turbo" }],      },    },  },}

OpenClaw は、multipart の OpenAI フォームアップロードではなく、input_audio 配下に base64 音声を含む JSON（OpenRouter の STT コントラクト）として OpenRouter STT リクエストを送信します。

Fusion ルーター

OpenRouter Fusion は、1 つの OpenClaw モデル参照を複数の OpenRouter モデルへ 並列送信し、OpenRouter に回答を評価させ、通常の OpenRouter エンドポイントを介して 1 つの最終レスポンスを返します。アップストリームのモデルスラッグは openrouter/fusion であるため、OpenClaw のモデル参照には OpenClaw の プロバイダープレフィックスとアップストリームの OpenRouter 名前空間の両方が含まれます。

openclaw models set openrouter/openrouter/fusion

Fusion のパネルと評価モデルは、モデルの params.extraBody を介して設定します。 これらのフィールドは OpenRouter の chat-completions リクエスト本文へ直接転送されます。 Fusion は OAuth と API キーのどちらのオンボーディングでも機能します。OAuth を使用する場合は、 以下の env.OPENROUTER_API_KEY 行を省略してください。

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      model: { primary: "openrouter/openrouter/fusion" },      models: {        "openrouter/openrouter/fusion": {          params: {            extraBody: {              plugins: [                {                  id: "fusion",                  analysis_models: [                    "google/gemini-3.5-flash",                    "moonshotai/kimi-k2.6",                    "deepseek/deepseek-v4-pro",                  ],                  model: "google/gemini-3.5-flash",                },              ],            },          },        },      },    },  },}

analysis_models は並列パネルで、Fusion Plugin 設定内の model は評価モデルです。Fusion を強制する目的で、通常の エージェント／チャットターンにおいてトップレベルの tool_choice を "required" に設定しないでください。OpenClaw のターンには独自の ツール定義が含まれる場合があり、トップレベルで必須のツール選択を指定すると、 Fusion ルーターではなくそれらのいずれかが選択される可能性があります。 この Fusion Plugin 設定が存在する場合、OpenClaw は設定済みの分析モデルと 評価モデルを列挙したサニタイズ済みのシステムプロンプト注記を追加します。 これにより、エージェントは自身の Fusion パネルに関する質問に回答できます。 その他の extraBody フィールドはプロンプトにコピーされません。

Fusion は設計上低速です。OpenRouter はプロンプトを複数の分析モデルへ ファンアウトし、その後に評価／統合ステップを実行するため、単一モデルへの 直接リクエストよりもレイテンシーが高くなります。意図的に高品質な回答を得る場合や エスカレーション経路で使用し、レイテンシー重視のデフォルトには使用しないでください。 パネルは小さく保ち、応答を速めるには高速な分析モデルと評価モデルを選択してください。

設定した参照を 1 回限りのローカル呼び出しでテストします。

openclaw infer model run --local \  --model openrouter/openrouter/fusion \  --prompt "Reply with exactly: FUSION_OK" \  --json

認証とヘッダー

OpenRouter は API キーの Bearer トークンを使用します。OpenRouter OAuth は OpenRouter API キーを発行する PKCE ログインフローであるため、OpenClaw は 手動の API キー設定で使用するものと同じ openrouter:default API キー認証 プロファイルに結果を保存します。

完全なオンボーディングを再実行せずに、既存のインストール環境でサインインまたは 保存済みキーのローテーションを行うには、次を実行します。

openclaw models auth login --provider openrouter --method oauthopenclaw models auth login --provider openrouter --method api-key

検証済みの OpenRouter リクエスト（https://openrouter.ai/api/v1）では、OpenClaw は OpenRouter のドキュメントに記載されたアプリ帰属ヘッダーを追加します。

高度な設定

{  agents: {    defaults: {      models: {        "openrouter/auto": {          params: {            responseCache: true,            responseCacheTtlSeconds: 300,          },        },      },    },  },}

{  models: {    providers: {      openrouter: {        params: {          provider: {            sort: "latency",            require_parameters: true,            data_collection: "deny",          },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openrouter/anthropic/claude-sonnet-4-6": {          params: {            provider: {              order: ["anthropic"],              allow_fallbacks: false,            },          },        },      },    },  },}

関連項目