通过 OpenRouter 一键接入百种 AI 模型

2026-02-10 · 6 分钟模型接入

什么是 OpenRouter

OpenRouter 是一个统一的 AI 模型路由平台，通过单一 API 端点即可访问来自 Anthropic、OpenAI、Google、Meta 等数十家提供商的上百种模型。对于希望灵活切换模型又不想分别管理多个 API Key 的用户来说，OpenRouter 是非常理想的选择。

获取 API Key

访问 OpenRouter 并注册账户
在 Dashboard 中创建 API Key
根据需要充值额度（支持多种支付方式）

配置步骤

设置环境变量

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

使用 onboard 命令

openclaw onboard --provider openrouter

按提示输入你的 OpenRouter API Key 即可完成配置。

配置文件

OpenRouter 兼容 OpenAI API 格式，在 OpenClaw 中作为独立提供者配置：

{
  providers: {
    openrouter: {
      type: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}"
      // 使用 Bearer token 认证
    }
  },
  agents: {
    default: {
      model: "openrouter/anthropic/claude-opus-4-5"
    }
  }
}

模型命名规则

OpenRouter 中的模型使用三段式命名：

openrouter/提供商/模型名

常用模型示例：

模型引用	说明
`openrouter/anthropic/claude-opus-4-5`	Claude Opus 4.5
`openrouter/anthropic/claude-sonnet-4-6`	Claude Sonnet 4.6
`openrouter/openai/gpt-5.2`	GPT-5.2
`openrouter/google/gemini-2.5-pro`	Gemini 2.5 Pro
`openrouter/meta-llama/llama-4-maverick`	Llama 4 Maverick
`openrouter/deepseek/deepseek-r1`	DeepSeek R1
`openrouter/mistralai/mistral-large`	Mistral Large

多模型灵活切换

OpenRouter 的最大优势在于只需一个 API Key 即可访问所有模型。利用这一特性，可以为不同任务分配不同模型：

{
  providers: {
    openrouter: {
      type: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}"
    }
  },
  agents: {
    // 复杂推理任务用 Claude Opus
    reasoning: {
      model: "openrouter/anthropic/claude-opus-4-5"
    },
    // 快速对话用 GPT
    chat: {
      model: "openrouter/openai/gpt-5.2"
    },
    // 代码生成用开源模型降低成本
    coder: {
      model: "openrouter/deepseek/deepseek-r1"
    }
  }
}

使用技巧

查看可用模型

OpenRouter 支持的模型列表更新频繁。可以通过以下方式查看当前可用模型：

openclaw models list --provider openrouter

成本控制

OpenRouter 各模型的定价不同。建议在 OpenRouter Dashboard 中设置月度预算上限，避免意外高额消费。

在 OpenClaw 中也可以为 Agent 设置单次请求的 token 上限：

{
  agents: {
    default: {
      model: "openrouter/anthropic/claude-sonnet-4-6",
      maxTokens: 4096
    }
  }
}

回退配置

可以配置模型回退链，当首选模型不可用时自动切换：

{
  agents: {
    default: {
      model: "openrouter/anthropic/claude-opus-4-5",
      fallback: [
        "openrouter/openai/gpt-5.2",
        "openrouter/google/gemini-2.5-pro"
      ]
    }
  }
}

常见问题

Q：OpenRouter 和直接使用各家 API 有什么区别？ OpenRouter 在价格上通常会有少量加成，但提供统一的 API 管理、模型发现和自动路由等便利功能。对于需要同时使用多家模型的场景，管理成本更低。

Q：延迟是否会增加？ 经过 OpenRouter 中转会增加少量延迟（通常 50-100ms）。对于对延迟不敏感的场景影响不大。

Q：中国大陆能否正常访问？ OpenRouter 服务器在海外，大陆用户可能需要配置网络代理才能正常使用。