OpenRouter

OpenRouter は、単一のエンドポイントと API キーの背後で多数のモデルへリクエストをルーティングする 統合 API を提供します。OpenAI 互換のため、ほとんどの OpenAI SDK はベース URL を切り替えるだけで動作します。

はじめに

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 は 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 のチャット補完画像 API に画像リクエストを送信します。Gemini 画像モデルは、サポートされている aspectRatio と resolution のヒントを OpenRouter の image_config 経由で受け取ります。遅い OpenRouter 画像モデルには 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 はテキストから動画、および画像から動画のジョブを OpenRouter に送信し、返された polling_url をポーリングして、OpenRouter の unsigned_urls またはドキュメント化されたジョブコンテンツエンドポイントから完成した動画をダウンロードします。参照画像はデフォルトで最初または最後のフレーム画像として送信されます。reference_image でタグ付けされた画像は OpenRouter 入力参照として送信されます。同梱の google/veo-3.1-fast デフォルトは、現在サポートされている 4/6/8 秒の長さ、720P/1080P 解像度、16:9/9:16 アスペクト比を公開します。上流の動画生成 API が現在テキストと画像参照を受け付けるため、動画から動画は OpenRouter には登録されていません。

音楽生成

OpenRouter はチャット補完の音声出力を通じて 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"] を送信し、ストリーミングを有効化し、ストリーミングされた音声チャンクを収集して、その結果をチャネル配信用の生成メディアとして保存します。参照画像は、共有の music_generate image=... パラメーターを通じて Lyria モデルで受け付けられます。

テキスト読み上げ

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 は、STT エンドポイント（/audio/transcriptions）を使用して、共有の tools.media.audio パス経由で受信した音声またはオーディオ添付ファイルを文字起こしできます。これは、受信音声またはオーディオをメディア理解の事前処理に転送する任意のチャネル Plugin に適用されます。

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

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

Fusion ルーター

1 つの OpenClaw モデル参照で複数の OpenRouter モデルに並列に問い合わせ、OpenRouter に回答を判定させ、通常の OpenRouter プロバイダーエンドポイントを通じて単一の最終応答を返したい場合は、OpenRouter Fusion を使用します。上流のモデルスラッグが openrouter/fusion であるため、OpenClaw モデル参照には OpenClaw プロバイダープレフィックスと上流の OpenRouter 名前空間の両方が含まれます。

openclaw models set openrouter/openrouter/fusion

Fusion のパネルと判定器は、モデルの params.extraBody を通じて設定します。これらのフィールドは OpenRouter チャット補完リクエスト本文に転送されます。Fusion は OpenRouter 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 が判定モデルです。通常の OpenClaw エージェントまたはチャットターンで Fusion を強制しようとして、トップレベルの tool_choice を "required" に設定しないでください。OpenClaw のターンには OpenClaw ツール定義が含まれる場合があり、トップレベルで必須のツール選択を指定すると、Fusion ルーターではなくそれらのツールのいずれかが必須になることがあります。この Fusion Plugin 設定が存在する場合、OpenClaw は設定された分析モデルと判定モデルを含むサニタイズ済みのシステムプロンプト注記も追加するため、エージェントは現在の Fusion パネルに関する質問に回答できます。他の extraBody フィールドはプロンプトにコピーされません。

Fusion は設計上遅くなります。OpenRouter は同じ OpenClaw プロンプトを複数の分析モデルに送信し、その後で最終的な判定または統合ステップを実行する場合があるため、レイテンシーは通常、単一モデルへの直接リクエストより高くなります。Fusion は、レイテンシーが重要なチャットのデフォルトとしてではなく、慎重で高品質な回答やエスカレーションパスに使用します。より高速な応答には、パネルを小さく保ち、より高速な分析モデルと判定モデルを選択します。

設定した参照を 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 キー認証プロファイルとして結果を保存します。

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

openclaw models auth login --provider openrouter --method oauth

OpenRouter で手動作成したキーを貼り付けたい場合は、openclaw 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,            },          },        },      },    },  },}

関連