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.imageGenerationModel に 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.imageGenerationModel.timeoutMs を使用します。ただし、 image_generate ツールの呼び出しごとの timeoutMs が常に優先されます。

動画生成

OpenRouter は、非同期の /videos API を介して video_generate ツールの バックエンドとして使用できます。agents.defaults.videoGenerationModel に 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.musicGenerationModel に 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 プロバイダーとして機能できます。

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

messages.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,            },          },        },      },    },  },}

関連項目