一把 key 搞定 300+ 模型:OpenClaw + OpenRouter 连起来,让 AI 机器人永不掉线

我这两天搞了一下 OpenClaw 和 OpenRouter 的组合。说实话，之前是真没碰过这俩。

事情起因是我发现了一个问题。

跑 AI 客服，最怕什么。不是模型笨，是模型会挂。一个供应商 API 抽风，你的机器人就断了，用户那边看到的消息还没发出去。很尴尬的事。

后来刷到 OpenRouter 博客上发了篇教程，教你怎么把 OpenClaw 和 OpenRouter 连起来。看完我愣了一下。不是哥们，这俩搭一块，好像真的挺香的。

来，先说说这俩都是什么东西。

OpenClaw 是一个开源的 AI Agent 框架。你把它想成一个超级接线员就行了，它能帮你同时管 Telegram、Discord、Slack、Signal、iMessage、WhatsApp 这些平台上的 AI 机器人。有人在上面跑客服，有人在上面跑群管理。关键是，它开源，你自己能部署，不用看谁脸色。

OpenRouter 是干吗的。它是一个模型聚合平台。你只需要一把 API key，就能直接调用 300+ 个模型，分布在 60+ 个供应商那里。Claude、Gemini、DeepSeek、Llama、Kimi，什么都有。关键是有自动 Failover，一个供应商挂了，它自动帮你切到另一个。不用你动手。你想想看，这年头谁没事还盯着一个供应商啊。

这俩以前是各玩各的。现在 OpenRouter 官方出了教程，教你怎么一键把它们连起来。连上之后，你就拥有了一个永远不死的 AI 机器人。

怎么连呢。非常简单。

装好 OpenClaw 之后，跑一条 onboard 命令，把你的 OpenRouter API key 传进去就行了。一把 key 进去，300+ 模型出来，完事了。

如果你想手动改配置文件也行，配置文件就在用户目录下面一个叫 openclaw.json 的文件。写进去你的 key 和你要用的模型，重启一下就行。

模型怎么叫

OpenClaw 调用 OpenRouter 的模型，有个固定的格式。

写法是 openrouter/<作者名>/<模型名>。

举几个常用的例子。

最新的 Claude Sonnet 叫 openrouter/~anthropic/claude-sonnet-latest。那个波浪号意思是自动跟踪最新一代，Anthropic 出了 Sonnet 5，它就自动切过去。不加波浪号，就定死在当前版本。

最新的 Gemini Flash 叫 openrouter/~google/gemini-flash-latest。

DeepSeek 叫 openrouter/deepseek/deepseek-chat。

Kimi 叫 openrouter/~moonshotai/kimi-latest。

还有个骚操作是后缀。在模型名后面加东西，能改变路由行为。

你品一下，这个设计其实挺聪明的。同一个模型，你想省资源就走免费的，想跑快点就走 nitro，想要更强的推理就走 thinking。不用换模型，就改个后缀的事。

加 :free，走免费端点。比如 openrouter/meta-llama/llama-3.3-70b-instruct:free，就是白嫖 Llama 70B。

加 :nitro，按吞吐量排序供应商，跑得快。

加 :thinking，要求模型输出扩展推理。

什么叫永远不死

这是我觉得最有价值的部分。

OpenRouter 帮你搞了两层保活。

第一层，叫供应商级别的 Failover。一个模型可能同时有好几个供应商在跑，第一个挂了或者限速了，它自动切第二个。你不用配置，它自己干的。

第二层，叫模型级别的 Fallback。你可以在配置文件里写一个 fallbacks 数组。主模型挂了，它按顺序试下一个。

比如主模型设的是 Claude Sonnet，挂了之后自动切到 Gemini Flash，再挂了切 DeepSeek。两个叠在一起，就是供应商挂了切供应商，模型挂了切模型。

你要是跑的是一个客服机器人，中途断了是很尴尬的事。消息发出去一半，状态没保存，用户那边看的就是一句半截话。Failover 就是来解决这个的。

省钱这事

OpenRouter 本身不加价。提供商报价多少，你就付多少。平台收 5.5% 的服务费，涵盖统一账单、Failover、一把 key 调用所有模型。

但它有 20+ 个免费模型。你想想看，对于那种低频场景，比如心跳检测、状态检查，根本不值当花钱。用 :free 型号就行。免费的东西不用白不用嘛。

还有一个 Auto Router。名字叫 openrouter/openrouter/auto。它会自动帮你选一个性价比最高的模型，按那个模型的正常价格收费，不额外收路由费。

OpenClaw 还能按不同 Agent 分配不同模型。比如你的 research 机器人用 Opus，summarizer 用免费 Llama。你只要在配置文件里指定就行。

这个设计很合理。不同的活，用不同的模型。research 要读长文档，必须上前沿模型。但 summarizer 处理短文本，免费模型完全够用。你让 Opus 天天给你写摘要，那是在烧钱。坦率的讲，我见过不少人就这么干的。

踩过的坑

连这俩的时候，有几个错误经常出现。我整理了一下。

“No API key found for provider openrouter”

这是 key 没送到 OpenClaw 手里。跑 echo $OPENROUTER_API_KEY 看看有没有输出。没有就检查一下环境变量。如果是服务器上跑的，变量可能在你的 shell 里加载了，但服务进程里没加载。这时候把 key 写到 openclaw.json 的 env 块里就行。

unknown model: openrouter/auto

这是模型名字写错了。正确的写法是 openrouter/openrouter/auto，两个 openrouter 都没错。作者名是 openrouter，模型名是 auto。我第一次写的时候就少写了一个。这玩意儿看着简单，真敲键盘的时候最容易出错。

OpenRouter not responding

这个有四个可能。

1）没钱了，去 openrouter.ai/keys 检查余额。

2）模型名写错了，跑 openclaw models list 看看能不能解析出来。

3）日志里有具体错误，openclaw logs --follow 去看。

4）网络不通，检查能不能访问 openrouter.ai 的域名。说实话，第四个原因我见得最多，服务器上的 egress rule 把出站请求拦了，你以为是 OpenRouter 挂了，结果是自家防火墙干的。

401 或 403

key 无效、被撤销、或者没钱了。去后台检查一下 key 的状态，更新配置，重启服务就行。

以上就是 OpenClaw 和 OpenRouter 连接的全部内容。你要是跑了 AI 客服、AI 群管理之类的东西，可以试试这个组合。一把 key 搞定 300+ 模型，供应商挂了也不怕断，还能按需选模型省钱。我觉得比一个个去各家申请 key 省事多了。

以上。如果觉得有用，随手点个赞吧。也想第一时间收到推送的，可以给个星标⭐。

谢谢你看我的文章，我们，下次再见。