MegaRouter 文档

快速开始

1. 创建 API 密钥

1. 前往 megarouter.com，选择登录模式，授权登录
2. 进入控制台 → 进入设置 → 进入 API 密钥 → 创建密钥

2. 自动路由（可选）

自动路由默认开启，控制方式：

进入控制台 → 进入设置 → 进入路由 → 自动路由开关

开启后，MegaRouter 会自动为每个请求选择最佳模型。如果你更倾向于自行选择模型，可跳过此步，直接指定模型（如 anthropic/claude-sonnet-4.6）。

标准接入

与 OpenAI API 完全兼容，支持 Python、Node.js、curl 等生态工具。

替换 Base URL ( https://api.megarouter.com/openai/v1 )与 API 密钥即可使用。

from openai import OpenAI

client = OpenAI(
    api_key="MEGAROUTER_API_KEY",  # get MEGAROUTER_API_KEY from megarouter.com (API Key)
    base_url="https://api.megarouter.com/openai/v1",
)

completion = client.chat.completions.create(
    model="auto",
    messages=[
        {"role": "system", "content": "system prompt"},
        {"role": "user", "content": "how are you?"}
    ],
)

# get the response from LLM (role=assistant)
print(completion.choices[0].message.content)

{
    "id": "243c850e-214c-431e-977f-ebaf4aa95f56",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "Hello! Nice to meet you. How can I help you?"
            },
            "finish_reason": "stop"
        }
    ],
    "created": 1773408946,
    "model": "deepseek.v3-v1:0",
    "object": "chat.completion",
    "usage": {
        "prompt_tokens": 5,
        "completion_tokens": 15,
        "total_tokens": 20
    }
}

OpenClaw 接入

如果您已安装好 OpenClaw，请按照以下步骤接入 MegaRouter。

接入 MegaRouter

方式 1：Web 控制台配置

1. 启动 Web 控制台

在终端中运行以下命令：

openclaw dashboard

浏览器会自动打开控制台页面（通常是 http://127.0.0.1:18789）。如果浏览器没有自动打开，请手动访问该地址。

2. 进入配置页面

选择 配置 → Raw 模式。

3. 添加 MegaRouter 配置

在 JSON 中添加 env，并将 MEGAROUTER_API_KEY 替换为您的 MegaRouter API 密钥：

env: {
    vars: {
      MEGAROUTER_API_KEY: 'sk-or-v1-xxxxxxxxxxxxxxxx',
    },
  },

添加 models，将 baseUrl 调整为 https://api.megarouter.com/openai/v1：

models: {
  mode: 'merge',
  providers: {
    megarouter: {
      baseUrl: 'https://api.megarouter.com/openai/v1',
      apiKey: '${MEGAROUTER_API_KEY}',
      api: 'openai-completions',
      models: [
        {
          id: 'megarouter/auto',
          name: 'MegaRouter Auto',
          api: 'openai-completions',
          reasoning: false,
          input: ['text'],
          cost: {
            input: 0,
            output: 0,
            cacheRead: 0,
            cacheWrite: 0,
          },
          contextWindow: 200000,
          maxTokens: 8192,
        },
      ],
    },
  },
},

替换原 "agents": {...} 部分为：

agents: {
  defaults: {
    model: {
      primary: 'megarouter/auto',
    },
    models: {
      'megarouter/auto': {
        alias: 'MegaRouter Auto',
      },
    },
  },
},

4. 保存并应用配置

Web 控制台：配置完成后，单击右上角 Save 保存配置，再单击 Update。

5. 验证接入成功

在 OpenClaw Chat 界面发送测试问题，例如：Hello。如果配置成功，系统会调用 MegaRouter API → 自动路由到最优模型 → 返回结果。

方式 2：编辑文件配置

1. 找到 openclaw.json 文件

macOS：

打开 Finder，快捷键：Command + Shift + G

输入：~/.openclaw

回车，就能看到 openclaw.json。

Windows：

路径：C:\Users\你的用户名\.openclaw\openclaw.json

2. 添加 MegaRouter 配置

在 JSON 中添加 env，并将 MEGAROUTER_API_KEY 替换为您的 MegaRouter API 密钥：

"env": {
  "vars": {
    "MEGAROUTER_API_KEY": "sk-or-v1-xxxxxxxxxxxxxxxx"
  }
},

添加 models，将 baseUrl 调整为 https://api.megarouter.com/openai/v1：

"models": {
  "mode": "merge",
  "providers": {
    "megarouter": {
      "baseUrl": "https://api.megarouter.com/openai/v1",
      "apiKey": "${MEGAROUTER_API_KEY}",
      "api": "openai-completions",
      "models": [
        {
          "id": "megarouter/auto",
          "name": "MegaRouter Auto",
          "api": "openai-completions",
          "reasoning": false,
          "input": ["text"],
          "cost": {
            "input": 0,
            "output": 0,
            "cacheRead": 0,
            "cacheWrite": 0
          },
          "contextWindow": 200000,
          "maxTokens": 8192
        }
      ]
    }
  }
},

替换原 "agents": {...}, 部分：

"agents": {
  "defaults": {
    "model": {
      "primary": "megarouter/minimax/minimax-m2.5"
    },
    "models": {
      "megarouter/auto": {
        "alias": "MegaRouter Auto"
      }
    }
  }
},

3. 保存及验证配置

保存配置文件后，在终端中运行以下命令查看内容，确认配置正确：

cat ~/.openclaw/openclaw.json

4. 验证接入成功

在本地终端中运行以下命令，即可通过命令行方式开始对话：

openclaw tui

也可以在终端中运行以下命令，在 OpenClaw Chat 界面进行对话：

openclaw dashboard

可选配置

自动模型路由

MegaRouter 推荐将 primary 设置为 megarouter/auto。

根据价格、延迟、可用性，自动选择最优模型。

指定模型

如果需要固定模型，例如：primary 设置为 megarouter/deepseek/deepseek-v3.2

常见问题

1. 当仅 OpenAI 系列模型请求成功，而其他模型均请求失败

   目前我们提供接入的模型均支持 OpenAI 通用协议。请在 OpenClaw 接入配置中，将 api 设置为 openai-completions（参见上文示例）。若 OpenAI 系列模型可用而其他模型均失败，请优先检查 providers 配置项中的 api 类型。

2. 提示找不到模型或回复为空

   请确认：模型 ID 拼写是否正确；配置中的 provider 名称与引用时是否一致；配置中的 reasoning 参数必须设置为 false。

QClaw 接入

如果您已安装好 QClaw，请按照以下步骤接入 MegaRouter。

对话式完成配置

1. 在对话中输入以下内容，请将 apiKey 替换为您的 MegaRouter API 密钥：

帮我新增一个provider
名称：MegaRouter
apiKey: sk-or-v1-xxxxxxxxxxxxxxxx
baseUrl: https://api.megarouter.com/openai/v1
模型（可传多个）： 1、auto  2、deepseek/deepseek-v3.2

QClaw 会自动添加成功并重启生效。

2. 验证是否成功

直接输入：「帮我验证一下 MegaRouter 配置有没有生效」。对话会返回「MegaRouter provider 已成功添加！」（以实际界面为准。）

3. 切换到 MegaRouter 使用

直接输入：「切换到 MegaRouter 下面的 auto」。对话会返回「已切换成功！」（以实际界面为准。）

AutoClaw 接入

1. 配置入口

点击左下角偏好设置，选择模型与 API，点击添加自定义模型。

2. 添加模型

• 服务商选择自定义。
• 添加 MegaRouter 支持的模型 ID，例如 deepseek/deepseek-v3.2。
• 填写显示名称，例如：MegaRouter(deepseek-v3.2)。
• 填写 API Key，例如：sk-or-v1-xxxxxxxxxxxxxxxx。
• 填写 Base URL：https://api.megarouter.com/openai/v1

3. 测试配置是否成功

点击连通测试，显示「测试成功」字样，则表示配置成功。

4. 模型使用

• 点击添加按钮，保存成功后，返回应用。
• 在聊天框下方选择切换模型，选择配置的 MegaRouter(deepseek-v3.2)，即可使用。

Cursor 接入

如果您已安装好 Cursor，请按照以下步骤接入 MegaRouter。

1. 打开 Cursor 设置

右上角菜单 → Settings。

2. 进入 Models 配置

在左侧菜单中：

• 找到并打开 Models。
• 点击 View All Models，滑到最底部，点击 Add Custom Model。
• 填写具体模型 ID，例如：deepseek/deepseek-v3.2。不能填写auto。

3. 添加 MegaRouter 配置

填写接入信息：

• 展开 API Keys。
• 填写您的 MegaRouter API 密钥。
• 填写 MegaRouter 的 Base URL：https://api.megarouter.com/openai/v1

4. 保存并关闭 Settings 页面。

5. 在 Cursor 中使用 MegaRouter

在Chat、Composer、Agent等对话界面中，模型选择下拉框选择添加 MegaRouter 模型，即可进行使用。

API 参考

端点

模型

模型 ID 格式：provider/model-name。版本号使用 .（如 4.6），而非 -。

更多模型可访问模型页面查看

故障排除