OpenRouter

OpenRouter 提供统一 API，通过一个密钥和一个端点访问多家 AI 提供商的模型。与 OpenAI API 兼容，只需切换 baseUrl 即可使用大多数 OpenAI SDK。

快速配置

向导

openclaw onboard --auth-choice apiKey --token-provider openrouter --token "$OPENROUTER_API_KEY"

配置文件

{
  env: { OPENROUTER_API_KEY: "sk-or-..." },
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
    },
  },
}

模型引用格式

OpenRouter 模型的格式为：openrouter/<提供商>/<模型>

常用模型示例：

openrouter/anthropic/claude-opus-4-6
openrouter/openai/gpt-4o
openrouter/meta-llama/llama-3.1-70b-instruct
openrouter/google/gemini-2.0-flash-exp
openrouter/deepseek/deepseek-r1

使用 OpenRouter 的优势

• 一个密钥，多家模型：不需要为每家提供商单独管理密钥
• 自动故障切换：OpenRouter 可在主模型不可用时自动切换
• 统一计费：所有模型使用统一账户充值，方便管理
• 访问稀缺模型：部分模型只能通过 OpenRouter 访问

配合备用模型使用

利用 OpenRouter 的多模型优势，可以设置更丰富的备用链：

{
  agents: {
    defaults: {
      model: {
        primary: "openrouter/anthropic/claude-sonnet-4-5",
        fallbacks: [
          "openrouter/openai/gpt-4o",
          "openrouter/meta-llama/llama-3.1-70b-instruct",
        ],
      },
      models: {
        "openrouter/anthropic/claude-sonnet-4-5": { alias: "Sonnet" },
        "openrouter/openai/gpt-4o": { alias: "GPT4o" },
      },
    },
  },
}

获取 API 密钥

访问 https://openrouter.ai/keys 创建 API 密钥。

注意：OpenRouter 使用 Bearer Token 方式，API 密钥格式为 sk-or-...