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 の chat completions image 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 は内部的に、API キーを使用した Bearer トークンを使用します。

実際の OpenRouter リクエスト（https://openrouter.ai/api/v1）では、OpenClaw は OpenRouter のドキュメント化されたアプリ帰属ヘッダーも追加します。

# 高度な設定

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

# 関連