OpenRouter

OpenRouter 提供一個統一 API，可透過單一端點與 API key 將請求路由到多種模型。它與 OpenAI 相容，因此大多數 OpenAI SDK 只要切換 base 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 圖像 API。Gemini 圖像模型會透過 OpenRouter 的 image_config 接收支援的 aspectRatio 與 resolution 提示。較慢的 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 長寬比。OpenRouter 未註冊影片轉影片，因為上游影片生成 API 目前接受文字與圖像參考。

文字轉語音

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 可以透過共用的 tools.media.audio 路徑，使用其 STT 端點（/audio/transcriptions）轉錄傳入的語音/音訊附件。這適用於任何會將傳入語音/音訊轉送到媒體理解預檢的通道 Plugin。

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

OpenClaw 會以 JSON 傳送 OpenRouter STT 請求，並在 input_audio 下放入 base64 音訊（OpenRouter STT 合約），而不是以 multipart OpenAI 表單上傳傳送。

驗證與標頭

OpenRouter 底層使用帶有你的 API key 的 Bearer token。

在實際 OpenRouter 請求（https://openrouter.ai/api/v1）上，OpenClaw 也會加入 OpenRouter 文件記載的應用歸因標頭：

進階設定

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

相關