Providers 导读

OpenRouter 接入:一条 API Key 通全部模型

OpenRouter 提供统一 API,只需一个密钥就能调用数百个模型。配置时先拿 API Key,运行 `openclaw onboard --auth-choice openrouter-api-key` 完成认证。注意:如果修改了 base URL,OpenClaw 不会自动注入 OpenRouter 专属头信息。

先讲这一页到底在解决什么

OpenRouter 接入:一条 API Key 通全部模型

OpenRouter 提供统一 API,只需一个密钥就能调用数百个模型。配置时先拿 API Key,运行 `openclaw onboard --auth-choice openrouter-api-key` 完成认证。注意:如果修改了 base URL,OpenClaw 不会自动注入 OpenRouter 专属头信息。

原文共 12 节,先看 Start Here 路径:/providers/openrouter 查看官方原文

第一步

🔑 先把 OpenRouter 门卡交给 OpenClaw

这一步没有花活,就是认证。

🛠

openclaw onboard --auth-choice apiKey --token-provider openrouter --token "$OPENROUTER_API_KEY"

像在总前台说:“我要进模型商场,这是我的门卡。”

📦

OPENROUTER_API_KEY

这张卡不是某一家模型专属钥匙,而是进总商场的统一通行证。

🏠

放哪里最稳

跟其他 provider 一样,最好放到 Gateway 长期值班时也能读到的地方。

🎈

一句话

OpenRouter 先认你的商场门卡,再帮你转去具体柜台。

第二步

🏷 模型名字为什么这么长?因为它在写“商场 / 店家 / 柜台”

官方最值得你看懂的,就是这个命名格式。

openrouter/anthropic/claude-sonnet-4-6

第一段 openrouter 像商场名字,第二段 anthropic 像进了哪家店,第三段才是柜台上具体哪位模型老师。

为什么不是直接 anthropic/...

因为你此时不是直连 Anthropic,而是先过 OpenRouter 这个总转运站。

🧭 这页真正想告诉你的事

OpenRouter 最有价值的地方,不是“名字长”,而是你能用同一种入口去切很多 provider 和模型。

🎈 一句话

模型名越长,不是越复杂,而是在把路径写完整。

第三步

📮 Bearer token 在现场像什么?像你进商场时给门卫看的通行证

官方最后一句说 OpenRouter 底层用 Bearer token。翻成人话,就是请求每次都会带着那张门卡去前台验票。

所以你看到 env: { OPENROUTER_API_KEY: "sk-or-..." } 这种配置,不是在“背参数”,而是在往总前台的验票机里塞通行证。

最后总结

🎈 把 OpenRouter 这页压成一句最好记的话

OpenRouter 不是某一个模型,而是模型商场总前台。你交一把门卡进去,再用 openrouter/店家/模型 这种路径告诉 OpenClaw 你到底要去哪个柜台。

如果你想知道“整栋 Gateway 大楼的总设置本到底怎么读”,下一页就该看配置总览。