OpenRouter

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

はじめに

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 は、OpenAI 互換の /audio/speech エンドポイントを通じて TTS プロバイダーとしても使用できます。

{  messages: {    tts: {      auto: "always",      provider: "openrouter",      providers: {        openrouter: {          model: "hexgrad/kokoro-82m",          voice: "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 リクエストをマルチパートの OpenAI フォームアップロードではなく、input_audio (OpenRouter STT 契約) に base64 音声を含む JSON として送信します。

認証とヘッダー

OpenRouter は内部的に、API キーを使用する Bearer トークンを使います。

実際の OpenRouter リクエスト (https://openrouter.ai/api/v1) では、OpenClaw は OpenRouter がドキュメント化しているアプリ帰属ヘッダーも追加します。

高度な設定

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

関連