OpenClaw + OpenRouter 完全教程：从零配置到 AI 模型自由切换

TL;DR：本文将手把手教你注册 OpenRouter 账号、创建 API Key，并在 OpenClaw 中完成配置，最终实现通过一个 API Key 自由切换 GPT、Claude、Gemini 等 300+ AI 模型。

一、为什么需要 OpenRouter？

如果你同时接触过 ChatGPT、Claude、Gemini 等多个 AI 模型平台，一定遇到过这些痛点：

每个平台都要单独注册、单独充值、单独管理 API Key
想对比不同模型的效果，要在多个平台之间来回切换
不同平台的 API 格式各不相同，集成成本高
想用一个模型做不擅长的任务时，没有自动 fallback 机制

OpenRouter 就是来解决这些问题的。它是一个 AI 模型聚合/路由平台，提供一个 统一且完全兼容 OpenAI 格式的 API 接口，让你通过一个 API Key 就能调用 GPT-5、Claude、Gemini 2.5、Llama、DeepSeek 等 300+ 模型。

而 OpenClaw 是一个个人 AI 智能体框架，原生支持 OpenRouter 作为模型提供商。两者结合后，你可以在自己的 AI 助手上随意切换模型，甚至配置自动回退。

二、注册 OpenRouter 账号

2.1 访问官网

打开浏览器，访问 https://openrouter.ai。

2.2 创建账号

点击页面右上角的 “Sign Up” 按钮，OpenRouter 支持以下注册方式：

Google 账号快捷登录（推荐，最省事）
GitHub 账号登录
邮箱注册

选择任意一种方式完成注册即可，整个过程不到 1 分钟。

2.3 关键设置：启用免费模型

⚠️ 这一步非常重要，否则免费模型不可用！

注册完成后，点击左侧菜单或顶部导航进入 Settings（设置） → Privacy（隐私），找到 “Allow free model usage” 或 “Data policy for free models” 选项并启用。

这个设置的意思是：当你使用免费模型时，OpenRouter 可能会将对话数据用于模型改进。如果不开启，系统会拒绝调用标注为 “Free” 的模型。

三、创建 API Key

3.1 进入 API Keys 页面

登录后，点击顶部导航栏的 “API Keys”（或直接访问 https://openrouter.ai/keys）。

3.2 创建新密钥

点击 “Create API Key” 按钮
给密钥取个好记的名字，比如 openclaw 或 main
点击 Confirm / Create

3.3 复制并保存 API Key

创建成功后，系统会显示你的 API Key，格式类似于：

sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ 请立即复制并妥善保存！ 这个 Key 只会在创建时显示一次，关闭页面后无法再查看完整的 Key（只能看到部分掩码）。如果丢失，只能重新创建一个。

四、充值 Credits

OpenRouter 采用预充值模式，需要购买 Credits 才能使用付费模型。

前往 https://openrouter.ai/credits 进行充值。当前支持的支付方式包括：

支付方式	手续费	最低充值
国际信用卡（Visa / MasterCard）	5.5%	$0.80
加密货币（USDC 等）	5%	无最低限制

一般从 5美元开始充值即可，对于日常测试和轻度使用足够支撑数月。

💡 免费模型：如果你只想体验，OpenRouter 提供了一些免费模型（带有 “Free” 标签），可以在不充值的情况下调用，但有速率限制。

五、浏览可用模型

OpenRouter 的模型列表页面在 https://openrouter.ai/models，可以在这里查看所有可用模型，按价格、提供商、能力等筛选。

每个模型的引用 ID 格式为：<provider>/<model-name>，例如：

模型	引用 ID	说明
Anthropic Claude Sonnet 4.5	`anthropic/claude-sonnet-4-5`	高性价比主力模型
Anthropic Claude Opus 4	`anthropic/claude-opus-4`	旗舰级推理能力
OpenAI GPT-5	`openai/gpt-5`	OpenAI 最新旗舰
Google Gemini 2.5 Pro	`google/gemini-2.5-pro`	超长上下文能力
Meta Llama 4	`meta-llama/llama-4-maverick`	开源最强
DeepSeek V3	`deepseek/deepseek-chat`	高性价比中文模型

六、在 OpenClaw 中配置 OpenRouter

OpenClaw 原生支持 OpenRouter，配置非常简单，有两种方式：

方式一：一键命令设置（推荐）

直接在终端运行以下命令：

openclaw onboard --auth-choice apiKey --token-provider openrouter --token "你的OpenRouter-API-Key"

例如：

openclaw onboard --auth-choice apiKey --token-provider openrouter --token "sk-or-v1-xxxxxxxxxxxxxxxxxxxx"

这会自动完成：

保存 API Key 到环境变量
设置 OpenRouter 为默认模型提供商
配置默认模型

方式二：手动编辑配置文件

配置文件位于 ~/.openclaw/openclaw.json（JSON5 格式，支持注释）。

完整配置示例：

{
  // 设置 OpenRouter API Key 环境变量
  env: {
    OPENROUTER_API_KEY: "sk-or-v1-your-api-key-here",
  },

  // 模型配置
  agents: {
    defaults: {
      // 主模型（OpenRouter 上的模型）
      model: {
        primary: "openrouter/anthropic/claude-sonnet-4-5",
        // 可选：设置备用模型，主模型不可用时自动回退
        fallbacks: [
          "openrouter/google/gemini-2.5-pro",
          "openrouter/openai/gpt-5",
        ],
      },
    },
  },
}

关键配置说明

模型引用格式：在使用 OpenRouter 时，模型引用需要带上 openrouter/ 前缀：

openrouter/<provider>/<model-name>

例如：

openrouter/anthropic/claude-sonnet-4-5 — Anthropic 的 Claude Sonnet
openrouter/google/gemini-2.5-pro — Google 的 Gemini
openrouter/deepseek/deepseek-chat — DeepSeek V3

通过 CLI 查看和切换模型

在运行 OpenClaw 后，你可以随时查看当前可用模型：

openclaw models

在聊天中使用 /model 命令可以临时切换当前会话的模型。

七、高级配置

7.1 环境变量方式引用 API Key

如果你不想在配置文件中明文写入 API Key，可以通过环境变量设置：

export OPENROUTER_API_KEY="sk-or-v1-xxxxxx"

然后在 openclaw.json 中使用变量引用：

{
  env: {
    OPENROUTER_API_KEY: "${OPENROUTER_API_KEY}",
  },
  // ... 其他配置
}

7.2 多模型按需调用

在 OpenClaw 的 Skills 或 Agent 配置中，你可以为不同场景指定不同模型。例如让图片生成任务走 openrouter/google/gemini-2.5-flash-image，文字推理任务走 openrouter/anthropic/claude-sonnet-4-5。

八、常见问题

Q: 调用 OpenRouter 时报错怎么办？

首先确认以下几点：

API Key 是否正确（以 sk-or-v1- 开头）
Credits 余额是否充足
OpenRouter 服务状态（访问 https://openrouter.ai/activity 查看）
如果使用的是免费模型，确认已在 Settings → Privacy 中启用免费模型权限

Q: 免费和付费模型有什么区别？

免费模型有速率限制（每分钟请求数有限制），对话数据可能用于模型改进。付费模型则无速率限制，数据隐私性更好。

Q: 一个 API Key 可以被多个应用共用吗？

可以。同一个 OpenRouter API Key 可以同时用于 OpenClaw、Cursor、Dify、自研应用等多个平台，共享同一个 Credits 余额。

九、总结

步骤	操作	地址
1	注册 OpenRouter 账号	openrouter.ai
2	启用免费模型权限	Settings → Privacy
3	创建 API Key	openrouter.ai/keys
4	充值 Credits（可选）	openrouter.ai/credits
5	浏览模型列表	openrouter.ai/models
6	在 OpenClaw 中配置	`openclaw onboard` 或编辑 `openclaw.json`

通过 OpenClaw + OpenRouter 的组合，你将拥有一个强大的个人 AI 中枢——随时调用全球最顶级的 AI 模型，自由切换，自动回退，一切尽在掌握。

相关资源

OpenClaw 官方文档

OpenClaw GitHub

OpenClaw 社区 Discord

OpenRouter 文档