OpenRouter
OpenRouter 提供一个统一 API,通过单一端点和 API 密钥将请求路由到多种模型。它兼容 OpenAI,因此大多数 OpenAI SDK 只需切换基础 URL 即可使用。
它在 OpenClaw 里很常见,因为:
- 接法接近 OpenAI 兼容接口
- 一个账号就能试很多 provider / model
- 还能顺手承担图片、视频、音乐、TTS、语音转写等能力
最常见的两种接入方式
OAuth
bash
openclaw onboard --auth-choice openrouter-oauthAPI Key
bash
openclaw onboard --auth-choice openrouter-api-key如果你只是想先跑通,通常推荐先用向导,再决定是否手动细调。
配置示例
json5
{
env: { OPENROUTER_API_KEY: "sk-or-..." },
agents: {
defaults: {
model: { primary: "openrouter/auto" },
},
},
}第一次接入时,openrouter/auto 往往比一上来手填具体模型更稳。
模型引用怎么写
常见写法:
text
openrouter/<provider>/<model>例如:
openrouter/autoopenrouter/anthropic/claude-sonnet-4-5openrouter/moonshotai/kimi-k2.6
Fusion 是什么
这是这页最容易被误解的点。
Fusion 不是普通模型别名,而是 OpenRouter 的并行路由 / 裁决器。
它会:
- 并行询问多个模型
- 由 OpenRouter 做评判
- 返回一个最终答案
在 OpenClaw 里的模型引用通常写成:
bash
openclaw models set openrouter/openrouter/fusion这里双 openrouter 前缀不是写错了,而是:
- 第一个
openrouter是 OpenClaw provider id - 第二个
openrouter/fusion是上游模型 slug
不只是文本模型
OpenRouter 现在还可以承担:
- 图片生成
- 视频生成
- 音乐生成
- TTS
- 入站语音转写
如果你想统一把多媒体能力也挂到一个云端入口,OpenRouter 是可行路线。
中文用户的实用建议
- 第一次接入先用
openrouter/auto - 跑通后再切具体模型
- 想试 Fusion 时,把它理解成“并行多模型裁决”,不要把它当普通型号
- 如果你用
/model固定了某个 OpenRouter 模型,后续想恢复默认配置,请用/model default
