OpenClaw通过OpenRouter接入多模型教程

前言

OpenRouter 是一个统一的 AI 模型网关，它让你用一个 API Key 就能访问几乎所有主流大模型，包括 Claude、GPT、Gemini、Llama、Mistral 等。对于不想分别注册多个平台的用户来说，OpenRouter 是一个极其便利的选择。本教程详细讲解如何在 OpenClaw 中配置 OpenRouter。

OpenRouter 的优势

特性	说明
一站式接入	一个 API Key 访问 200+ 模型
统一计费	所有模型费用统一结算
自动故障切换	某个提供商出问题时自动切换到备选
无需科学上网	部分模型可直接访问（视地区而定）
免费模型	提供部分开源模型的免费额度

第一步：注册 OpenRouter 并获取 API Key

1.1 注册账号

访问 openrouter.ai
使用 Google 账号或邮箱注册
完成注册后进入 Dashboard

1.2 创建 API Key

进入 Keys 页面
点击 Create Key
填写名称，例如 openclaw-prod
复制生成的密钥

API Key 格式：

sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

1.3 充值（可选）

OpenRouter 支持多种支付方式。部分开源模型有免费额度，但 Claude、GPT 等商业模型需要预充值。建议先充 $5 试用。

第二步：基础配置

2.1 编辑配置文件

nano ~/.config/openclaw/openclaw.json5

添加 OpenRouter 配置：

{
  models: {
    openrouter: {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "anthropic/claude-sonnet-4",
    }
  }
}

2.2 设置环境变量

# 添加到 ~/.bashrc
export OPENROUTER_API_KEY="sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
source ~/.bashrc

2.3 重启验证

openclaw restart
openclaw doctor

第三步：可用模型一览

通过 OpenRouter 可以访问以下主流模型：

模型	OpenRouter 标识	输入价格 (每百万token)	输出价格 (每百万token)
Claude Sonnet 4	anthropic/claude-sonnet-4	$3.00	$15.00
Claude Haiku 3.5	anthropic/claude-3.5-haiku	$0.80	$4.00
GPT-4o	openai/gpt-4o	$2.50	$10.00
GPT-4o mini	openai/gpt-4o-mini	$0.15	$0.60
Gemini 2.5 Pro	google/gemini-2.5-pro	$1.25	$10.00
Gemini 2.5 Flash	google/gemini-2.5-flash	$0.15	$0.60
Llama 3.3 70B	meta-llama/llama-3.3-70b	$0.10	$0.10
DeepSeek V3	deepseek/deepseek-chat	$0.14	$0.28
Mistral Large	mistralai/mistral-large	$2.00	$6.00
Qwen 2.5 72B	qwen/qwen-2.5-72b-instruct	$0.15	$0.15

3.1 免费模型

OpenRouter 提供部分模型的免费额度，适合试用和低频使用：

{
  models: {
    "openrouter-free": {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "meta-llama/llama-3.3-70b:free",  // 免费版标识
    }
  }
}

注意：免费模型的速率限制较严，不适合高频使用。

第四步：多模型配置

OpenRouter 的核心优势是可以灵活切换多个模型。

4.1 为不同频道配置不同模型

{
  models: {
    "router-premium": {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "anthropic/claude-sonnet-4",
    },
    "router-standard": {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "google/gemini-2.5-flash",
    },
    "router-budget": {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "meta-llama/llama-3.3-70b",
    }
  },
  channels: {
    whatsapp: {
      model: "router-premium",     // WhatsApp 使用最强模型
    },
    telegram: {
      model: "router-standard",   // Telegram 使用中档模型
    },
    discord: {
      model: "router-budget",     // Discord 使用经济模型
    }
  }
}

4.2 模型路由策略

OpenRouter 支持自动路由功能，根据请求内容自动选择最合适的模型：

{
  models: {
    "router-auto": {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "openrouter/auto",   // 自动选择最佳模型
      parameters: {
        temperature: 0.7,
      }
    }
  }
}

第五步：故障切换配置

当某个模型提供商出现故障时，OpenRouter 可以自动切换到备选模型。

5.1 配置 Fallback 列表

{
  models: {
    "router-resilient": {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "anthropic/claude-sonnet-4",
      fallbackModels: [
        "openai/gpt-4o",
        "google/gemini-2.5-pro",
        "deepseek/deepseek-chat",
      ],
      retryOnFailure: true,
      maxRetries: 2,
    }
  }
}

5.2 工作原理

故障切换的触发流程：

请求发送 → Claude Sonnet 4
    ↓ 失败
重试 → GPT-4o
    ↓ 失败
重试 → Gemini 2.5 Pro
    ↓ 失败
最终重试 → DeepSeek Chat
    ↓ 成功
返回响应

这种配置确保了极高的可用性，即使某个提供商完全宕机也不影响服务。

第六步：成本优化

6.1 设置预算限制

在 OpenRouter Dashboard 中可以设置总预算和每日限额。同时在 OpenClaw 配置中也可以加一层控制：

{
  models: {
    openrouter: {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "google/gemini-2.5-flash",
      budget: {
        dailyLimit: 2.00,          // 每日最多花费 $2
        monthlyLimit: 30.00,       // 每月最多花费 $30
        alertThreshold: 0.8,       // 达到 80% 时发出告警
      }
    }
  }
}

6.2 按任务复杂度选择模型的策略

一个聪明的做法是根据任务类型动态选择模型：

{
  models: {
    "router-smart": {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "google/gemini-2.5-flash",    // 默认用便宜的
      complexModel: "anthropic/claude-sonnet-4",   // 复杂任务用强模型
      complexTriggers: [
        "代码",
        "分析",
        "翻译长文",
        "写文章",
      ]
    }
  }
}

第七步：高级配置选项

7.1 自定义 HTTP Headers

某些场景可能需要传递额外的 HTTP 头信息：

{
  models: {
    openrouter: {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "anthropic/claude-sonnet-4",
      headers: {
        "HTTP-Referer": "https://your-site.com",  // 帮助 OpenRouter 统计来源
        "X-Title": "OpenClaw Assistant",           // 显示在 OpenRouter 日志中
      }
    }
  }
}

7.2 禁用特定提供商

如果你不希望通过某些提供商访问模型：

{
  models: {
    openrouter: {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "anthropic/claude-sonnet-4",
      providerPreferences: {
        exclude: ["azure"],        // 不使用 Azure 提供的模型
        prefer: ["anthropic"],     // 优先使用 Anthropic 直连
      }
    }
  }
}

常见问题

余额不足

Error: 402 Payment Required - Insufficient credits

前往 OpenRouter Dashboard 充值后即可恢复。

模型不可用

Error: 503 Model temporarily unavailable

这通常是上游提供商的临时问题。配置了 fallbackModels 可以自动切换，否则等待几分钟后重试。

响应速度慢

OpenRouter 作为中间层会增加少许延迟（通常 100-300ms）。如果对延迟极其敏感，建议直连对应的模型提供商。

小结

OpenRouter 是 OpenClaw 生态中一个强大的模型聚合方案。它的核心价值在于简化多模型管理、提供故障切换能力、统一计费。对于想要灵活使用多个模型但不想分别管理各家 API 的用户，OpenRouter 是最佳选择。建议将其作为备用方案或主力方案，搭配故障切换配置，实现高可用的 AI 助手服务。