OpenRouter

OpenRouter 透過單一 API 和單一金鑰將請求路由至多個模型。它與 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/<provider>/<model> 參照，包括 openrouter/openrouter/fusion（請參閱 Fusion 路由器），都會根據 OpenRouter 的即時模型目錄動態解析。

圖片生成

OpenRouter 可支援 image_generate 工具。在 agents.defaults.mediaModels.image 下設定 OpenRouter 圖片模型：

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      imageGenerationModel: {        primary: "openrouter/google/gemini-3.1-flash-image-preview",        timeoutMs: 180_000,      },    },  },}

OpenClaw 會透過 OpenRouter 的聊天補全圖片 API，使用 modalities: ["image", "text"] 傳送圖片請求。Gemini 圖片模型還會透過 OpenRouter 的 image_config 接收 aspectRatio 和 resolution 提示；其他 圖片模型則不會。對較慢的模型使用 agents.defaults.mediaModels.image.timeoutMs； image_generate 工具每次呼叫的 timeoutMs 仍具有優先權。

影片生成

OpenRouter 可透過其非同步 /videos API 支援 video_generate 工具。在 agents.defaults.mediaModels.video 下設定 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 可透過聊天補全音訊輸出支援 music_generate 工具。在 agents.defaults.mediaModels.music 下設定 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=... 參數接受一張參照圖片。 串流音訊、逐字稿保留及衍生的 SSE 事件封套受 agents.defaults.mediaMaxMb 限制（預設音訊上限為 16 MB）。

文字轉語音

OpenRouter 可透過其與 OpenAI 相容的 /audio/speech 端點作為 TTS 提供者。

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

若省略 tts.providers.openrouter.apiKey，TTS 會先備援至 models.providers.openrouter.apiKey，再備援至 OPENROUTER_API_KEY。

語音轉文字（傳入音訊）

OpenRouter 可使用其 STT 端點（/audio/transcriptions），透過共用的 tools.media.audio 路徑轉錄傳入的語音／音訊附件。 這適用於任何將傳入語音／音訊轉送至媒體理解預檢的頻道外掛。

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

OpenClaw 會依 OpenRouter 的 STT 合約，將 OpenRouter STT 請求作為 JSON 傳送，並把 base64 音訊放在 input_audio 下，而不是使用 multipart OpenAI 表單上傳。

Fusion 路由器

OpenRouter Fusion 會將一個 OpenClaw 模型參照平行傳送至數個 OpenRouter 模型，讓 OpenRouter 評判其答案，再透過一般 OpenRouter 端點傳回一個最終 回應。上游模型 slug 為 openrouter/fusion，因此 OpenClaw 模型參照同時 包含 OpenClaw 提供者前綴與上游 OpenRouter 命名空間：

openclaw models set openrouter/openrouter/fusion

透過模型的 params.extraBody 設定 Fusion 的模型小組與評判模型； 這些欄位會直接轉送至 OpenRouter 聊天補全請求主體。 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 外掛設定內的 model 是評判模型。在一般代理／聊天輪次中，不要為了強制使用 Fusion 而將頂層 tool_choice 設為 "required"：OpenClaw 輪次可能包含自己的工具定義，而頂層的必要工具選擇可能會選到其中一個工具， 而不是 Fusion 路由器。當存在此 Fusion 外掛設定時，OpenClaw 會加入經清理的 系統提示註記，列出已設定的分析模型與評判模型，讓代理能回答有關自身 Fusion 模型小組的問題。其他 extraBody 欄位不會複製至提示中。

Fusion 的設計本來就較慢：OpenRouter 會將提示分送至多個分析模型， 再執行評判／綜合步驟，因此延遲會高於直接向單一模型提出請求。 適合將其用於需要深思熟慮的高品質答案或升級處理路徑，而不是設為對延遲敏感的 預設選項。模型小組應保持精簡，並選擇較快的分析／評判模型以縮短回應時間。

使用單次本機呼叫測試已設定的參照：

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

相關內容