简要总结
OpenRouter
这页说明书在教你用一个叫 OpenRouter 的“聪明小帮手”。这个小帮手很厉害,它认识很多很多不同的大模型(你可以把它们想成不同性格的机器人朋友),而你只需要记住一个地址和一把钥匙,就能让这个小帮手帮你叫出任何一个机器人朋友来聊天。这页适合在你已经拿到了 OpenRouter 的钥匙,想开始使用它的时候看。
五岁小孩版解释
OpenRouter 就像一个超级厉害的“机器人呼叫中心”。你有很多机器人朋友,比如 Claude、GPT 等等,它们各自住在不同的地方,有不同的门牌号和开门密码。如果每次都要找不同的地址和密码,那就太麻烦了!OpenRouter 就是来解决这个麻烦的。它给你一个统一的“呼叫号码”(API)和一把“万能钥匙”(API 密钥),你只要告诉它你想找哪个机器人,它就会帮你接通,非常方便。而且,它和 OpenAI 家的呼叫方式很像,所以很多原本为 OpenAI 设计的工具,只要改一下地址就能直接用。
要开始使用 OpenRouter,你需要先在你的电脑上告诉 OpenClaw 工具:“嘿,我有一把 OpenRouter 的钥匙!” 这个动作叫做设置。你需要打开一个叫“终端”或“命令行”的窗口(就像电脑的一个秘密控制台),然后输入一句“咒语”:
openclaw onboard --auth-choice apiKey --token-provider openrouter --token “你的钥匙”
这句话的意思是:启动 OpenClaw 的设置向导,选择用“钥匙”的方式登录,钥匙的提供者是 OpenRouter,钥匙的具体内容就是你手里的那一串。这里要小心:你需要把 “你的钥匙” 这几个字,换成你自己真正的 OpenRouter API 密钥,它通常以 sk-or-... 开头。记得密钥要放在英文的双引号里面哦。
设置好之后,我们还需要写一个小小的“使用说明书”给 OpenClaw 看,这样它才知道平时该找哪个机器人玩。这个说明书是一个叫 config 的配置文件。你需要在这个文件里写上两件重要的事:
- 把你的 OpenRouter 钥匙放在一个叫
OPENROUTER_API_KEY的“密码盒”(环境变量)里。 - 告诉它,默认情况下,你想和哪个机器人模型聊天。
这个说明书大概长这样:
{
env: { OPENROUTER_API_KEY: “sk-or-...” },
agents: {
defaults: {
model: { primary: “openrouter/anthropic/claude-sonnet-4-5” },
},
},
}
你看,在 env 那里放好了钥匙,在 model 那里指定了想找 openrouter/anthropic/claude-sonnet-4-5 这个机器人。这样,每次你让 OpenClaw 工作,它就会自动用你的钥匙去 OpenRouter 那里找这个指定的机器人了。
这里有几个小提醒要告诉你:
- 当你指定想找哪个机器人时,名字的写法是固定的,就像
openrouter/<提供者>/<模型名>。比如例子里的anthropic就是提供者,claude-sonnet-4-5就是模型名。 - 如果你想看看 OpenRouter 还能呼叫哪些其他有趣的机器人,可以去看看文档里关于“模型提供者”的那一页。
- 最后,OpenRouter 在后台其实是用一种叫“Bearer token”的方式使用你的钥匙的。你可以把它想成:它不是直接把钥匙给人看,而是把钥匙放在一个特制的、只能使用一次的“令牌”里递过去,这样更安全。