Documentação do MegaRouter

Primeiros passos

Criar uma chave API

1. Aceda ao megarouter.com, escolha o método de início de sessão e autorize
2. Ir para Consola → Definições → Chaves de API → Criar uma chave

2. Encaminhamento automático (opcional)

O encaminhamento automático está ativado por predefinição. Para o controlar:

Consola → Definições → Encaminhamento → Botão de encaminhamento automático

Depois de ativado, o MegaRouter seleciona automaticamente o melhor modelo para cada pedido. Se preferir escolher os modelos manualmente, pode saltar este passo e especificá-los diretamente (por exemplo, anthropic/claude-sonnet-4.6).

Configuração padrão

Totalmente compatível com a API OpenAI. Suporta Python, Node.js, curl e ferramentas em todo o ecossistema.

Substituir a URL base ( https://api.megarouter.com/openai/v1 ) e a chave de API para começar a utilizar.

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
    }
}

Configuração do OpenClaw

Se já tiver o OpenClaw instalado, siga os passos abaixo para ligar o MegaRouter.

Ligar MegaRouter

Método 1: Consola web

1. Iniciar a consola web

Num terminal, execute:

openclaw dashboard

O browser abrirá a consola (normalmentehttp://127.0.0.1:18789). Se o navegador não abrir automaticamente, deverá visitar esse endereço manualmente.

2. Aceder à página de configuração

Selecione Config → Modo Raw

3. Adicionar configuração do MegaRouter

Adicione a variável env e defina MEGAROUTER_API_KEY com a sua chave de API da MegaRouter:

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

Adicionar modelos com baseUrl definido para 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,
        },
      ],
    },
  },
},

Substituir a secção original "agentes": {...} por:

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

4. Guardar e aplicar configuração

Web console: Clicar em Guardar no canto superior direito, depois em Atualizar.

5. Verificar ligação

No OpenClaw Chat, envie uma mensagem de teste como "Olá". Se configurado corretamente, a API MegaRouter é chamada → encaminhada automaticamente para o melhor modelo → a resposta é devolvida.

Método 2: Editar ficheiro de config

1. Localizar o ficheiro openclaw.json

macOS:

Abrir o Finder, pressionar Command + Shift + G

Entrar~/.openclaw

Pressione Enter para veropenclaw.json.

Windows:

Percurso:C:\Users\<YourUsername>\.openclaw\openclaw.json

2. Adicionar configuração do MegaRouter

Adicione a variável env e defina MEGAROUTER_API_KEY com a sua chave de API da MegaRouter:

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

Adicionar modelos com baseUrl definido para 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
        }
      ]
    }
  }
},

Substituir a secção original "agentes": {...}, por:

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

3. Guardar e verificar a configuração

Após guardar o ficheiro de configuração, executa-se o seguinte num terminal para visualizar o ficheiro e confirmar que está correto:

cat ~/.openclaw/openclaw.json

4. Verificar ligação

Executar o seguinte num terminal local para iniciar uma conversa CLI:

openclaw tui

Ou executar o seguinte para utilizar o OpenClaw Chat no navegador:

openclaw dashboard

Configuração opcional

Encaminhamento automático de modelos

MegaRouter recomenda definir primário como megarouter/auto.

Seleciona automaticamente o melhor modelo por preço, latência e disponibilidade

Utilizar um modelo específico

Para utilizar um modelo fixo, por exemplo, defina o primário como megarouter/deepseek/deepseek-v3.2

Perguntas frequentes

1. Apenas os modelos OpenAI têm sucesso; os outros modelos falham.

   Os modelos disponíveis através do MegaRouter utilizam o protocolo compatível com a OpenAI. Nas configurações de integração do OpenClaw, defina o campo api paraopenai-completions(conforme os exemplos acima). Se os modelos da família OpenAI funcionarem, mas todos os outros falharem, verifique aprovidersentrada: oapitipo.

2. Modelo não encontrado ou resposta vazia

   Verifique se a grafia do ID do modelo está correta; o nomeproviderconfigurado corresponde ao referido; ereasoningdeve ser definido parafalse.

Configuração do QClaw

Se já tiver o OpenClaw instalado, siga os passos abaixo para ligar o MegaRouter.

Configurar no chat

1. No chat, envie a mensagem abaixo. Substitua o valor apiKey pela chave API MegaRouter.

Ajude-me a adicionar um novo fornecedor
Nome: MegaRouterapiKey: sk-or-v1-xxxxxxxxxxxxxxxx
baseUrl: https://api.megarouter.com/openai/v1
Modelos (pode indicar vários): 1. auto 2. deepseek/deepseek-v3.2

O QClaw vai adicionar o fornecedor e reiniciar automaticamente.

2. Verificar

Pergunte: "Ajude-me a verificar se a configuração do meu MegaRouter está a funcionar." O assistente deverá responder com algo do tipo "O fornecedor do MegaRouter foi adicionado com sucesso!" (a formulação exata pode variar.)

3. Mudar para MegaRouter

Pergunte: "Mudar para o modo automático no MegaRouter." O assistente deverá responder com algo do tipo "Mudança efetuada com sucesso!" (a formulação exata pode variar.)

Configuração do AutoClaw

1. Abrir a entrada de configuração

Clicar em Preferências no canto inferior esquerdo, ir a Modelos e API e clicar em Adicionar modelo personalizado.

2. Adicionar um modelo

• Definir o fornecedor como Personalizado.
• Insira um ID de modelo compatível com MegaRouter, por exemplo, deepseek/deepseek-v3.2.
• Introduza um nome de ecrã, por exemplo, MegaRouter(deepseek-v3.2).
• Introduza a sua chave API, por exemplo, sk-or-v1-xxxxxxxxxxxxxxxx.
• URL base: https://api.megarouter.com/openai/v1

3. Testar a configuração

Clique no teste de conexão. Se aparecer "Teste bem-sucedido", a configuração está correta.

4. Utilizar o modelo

• Clique em Adicionar. Após guardar, volte à aplicação.
• Abaixo do campo de chat, mude o modelo para o seu configuradoMegaRouter(deepseek-v3.2)para o utilizar.

Configuração do cursor

Se já tiver o Cursor instalado, siga estes passos para ligar o MegaRouter.

1. Abrir definições do Cursor

Utilizar o menu no canto superior direito → Definições.

2. Modelos

Na barra lateral esquerda:

• Modelos abertos.
• Escolha Ver Todos os Modelos, desloque até ao fundo, depois Adicionar Modelo Personalizado.
• Introduzir o ID do modelo específico, por exemplo, deepseek/deepseek-v3.2. Não utilize a opção "automático".

3. Adicionar MegaRouter

Configurar acesso à API:

• Expanda chaves de API.
• Cole a chave da API MegaRouter.
• Defina o URL base para https://api.megarouter.com/openai/v1

4. Guardar e fechar a página Definições.

5. Utilizar o MegaRouter no Cursor

No Chat, Composer ou Agent, selecione o seu modelo MegaRouter no menu suspenso de modelos.

Configuração do Hermes

Pré-requisitos

• Criar umaChave de APIna consola do MegaRouter.
• Se utilizar o encaminhamento automático, ative-o em Definições → Encaminhamento na consola.

Opção 1: Configuração do terminal

1. Escolher modelo e endpoint personalizado

Execute no terminal:

hermes model

No menu, selecione Personalizar endpoint e preencha os campos:

Se lhe for solicitado o comprimento do contexto, prima Enter para deixar esse campo em branco (o Hermes irá detetá-lo).

2. (Opcional) painel de controlo web local

Para editar a configuração no navegador, execute:

hermes dashboard

3. Verificar

hermes chat "Hello"

Sucesso significa que o pedido chegou ao MegaRouter e que o encaminhamento inteligente ou o modelo escolhido devolveu um resultado.

Também pode executarhermes doctorpara verificar a ligação

Opção 2: Editar ficheiros de configuração

1. Localizações dos ficheiros

macOS / Linux

• ~/.hermes/config.yaml, configuração principal (modelo, fornecedor, base_url, api_key, etc.)
• ~/.hermes/.env, segredos e variáveis de ambiente (recomendado)

Windows:

• C:\Users\<username>\.hermes\config.yaml
• C:\Users\<username>\.hermes\.env

2. Guardar a chave API em.env(escolha uma opção)

Opção A (mesmo nome que o MegaRouter)

# MegaRouter API 密钥
MEGAROUTER_API_KEY=sk-or-v1_xxxxxxxxxxxxxxxxxxxxx

Opção B (convenção comum de endpoint personalizado do Hermes)

Semodel.api_keynão está definido para um endpoint personalizado, o Hermes recorre aOPENAI_API_KEY. Coloque a sua chave MegaRouter aqui:

OPENAI_API_KEY=sk-or-v1_xxxxxxxxxxxxxxxxxxxxx

docs.hermes.m2s3ZhBeforeconfig.yamldocs.hermes.m2s3ZhMidmodel

Encaminhamento automático (auto)

model:
  default: auto
  provider: custom
  base_url: https://api.megarouter.com/openai/v1
  api_key: ${MEGAROUTER_API_KEY}

Se usar a Opção B, deixeapi_keyem branco ou elimine-o para que o Hermes utilizeOPENAI_API_KEY.

O Hermes expande-se${VAR}ao carregar a configuração (as variáveis devem existir no ambiente, geralmente a partir de~/.hermes/.env).

Exemplo de modelo fixo

O ID do modelo tem de corresponder aoLista de modelos MegaRouter.

model:
  default: deepseek/deepseek-v3.2
  provider: custom
  base_url: https://api.megarouter.com/openai/v1
  api_key: ${MEGAROUTER_API_KEY}

4. Verificar após guardar

Após guardar, executehermes chat "Hello"para verificar a ligação MegaRouter

Múltiplas rotas / modelos

docs.hermes.multiSeg1autodocs.hermes.multiSeg2deepseek/deepseek-v3.2docs.hermes.multiSeg3config.yamldocs.hermes.multiSeg4custom_providersdocs.hermes.multiSeg5megarouter-autodocs.hermes.multiSeg6

model:
  default: auto
  provider: custom
  base_url: https://api.megarouter.com/openai/v1
  api_key: ${MEGAROUTER_API_KEY}

custom_providers:
  - name: megarouter-auto
    base_url: https://api.megarouter.com/openai/v1
    api_key: ${MEGAROUTER_API_KEY}
    model: auto

  - name: megarouter-deepseek
    base_url: https://api.megarouter.com/openai/v1
    api_key: ${MEGAROUTER_API_KEY}
    model: deepseek/deepseek-v3.2

Como alternar

1. Terminal: executemodelo hermesnovamente e selecione a rota nomeada ou o endpoint Personalizado.
2. No chat (TUI): utilize o/modelsintaxe da documentação do Hermes, por exemplo:

/model custom:megarouter-auto:auto
/model custom:megarouter-deepseek:deepseek/deepseek-v3.2

(Os nomes seguemcustom_providers[].name; formato écustom:<profile name>:<model id>.)

Perguntas frequentes

Referência da API

Pontos finais

Modelos

Formato do ID do modelo: fornecedor/nome-do-modelo. Os números de versão utilizam . (ex.: 4.6), não -.

Para mais modelos, visite aModelosModelos.

Resolução de problemas