OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书

简要总结

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 的配置文件。你需要在这个文件里写上两件重要的事:

  1. 把你的 OpenRouter 钥匙放在一个叫 OPENROUTER_API_KEY 的“密码盒”(环境变量)里。
  2. 告诉它,默认情况下,你想和哪个机器人模型聊天。

这个说明书大概长这样:

{
  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”的方式使用你的钥匙的。你可以把它想成:它不是直接把钥匙给人看,而是把钥匙放在一个特制的、只能使用一次的“令牌”里递过去,这样更安全。