Documentación de MegaRouter

Primeros pasos

Crear una clave API

1. Ve a megarouter.com, elige el método de inicio de sesión y autoriza
2. Ve a Consola → Ajustes → Claves API → Crear una clave

2. Enrutamiento automático (opcional)

El enrutamiento automático está activado por defecto. Para controlarlo:

Consola → Ajustes→ Enrutamiento → Alternar enrutamiento automático

Una vez activado, MegaRouter selecciona automáticamente el mejor modelo para cada solicitud. Si prefieres seleccionar los modelos tú mismo, omite este paso y especifica los modelos directamente (p. ej., anthropic/claude-sonnet-4.6).

Configuración estándar

Totalmente compatible con la API de OpenAI. Admite Python, Node.js, curl y herramientas de todo el ecosistema.

Reemplaza la URL base ( https://api.megarouter.com/openai/v1 ) y la clave API para empezar a usarlo.

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

Configuración de OpenClaw

Si ya tienes OpenClaw instalado, sigue los pasos a continuación para conectar MegaRouter.

Conectar MegaRouter

Método 1: consola web

1. Inicia la consola web

En una terminal, ejecuta:

openclaw dashboard

El navegador abrirá la consola (normalmentehttp://127.0.0.1:18789). Si el navegador no se abre automáticamente, visita esa dirección de forma manual.

2. Ve a la página de configuración

Selecciona Configuración → Modo sin procesar.

3. Agrega configuración de MegaRouter

Añade la variable de entorno y define MEGAROUTER_API_KEY como tu clave de API de MegaRouter:

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

Añade modelos con baseUrl establecida en 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,
        },
      ],
    },
  },
},

Reemplaza la sección original “agents”: {...} por:

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

4. Guarda y aplica la configuración

Consola web: haz clic en Guardar en la esquina superior derecha y luego en Actualizar.

5. Verifica la conexión

En OpenClaw Chat, envía un mensaje de prueba como “Hola”. Si se configura correctamente, se llama a la API MegaRouter → se enruta automáticamente al mejor modelo → se devuelve la respuesta.

Método 2: editar archivo de configuración

1. Encuentra el archivo openclaw.json

macOS:

Abre Finder, presiona Comando + Mayús + G

Introduce:~/.openclaw

Presiona Entrar para veropenclaw.json.

Windows:

RutaC:\Users\<YourUsername>\.openclaw\openclaw.json

2. Añade la configuración de MegaRouter

Añade la variable de entorno y define MEGAROUTER_API_KEY como tu clave de API de MegaRouter:

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

Añade modelos con baseUrl establecida en 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
        }
      ]
    }
  }
},

Reemplaza la sección original "agents": {...}, por:

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

3. Guardar y verificar la configuración

Después de guardar el archivo de configuración, ejecuta lo siguiente en una terminal para ver el archivo y confirmar que es correcto:

cat ~/.openclaw/openclaw.json

4. Verificar conexión

Ejecuta lo siguiente en una terminal local para iniciar una conversación CLI:

openclaw tui

O ejecuta lo siguiente para usar OpenClaw Chat en el navegador:

openclaw dashboard

Configuración opcional

Enrutamiento automático de modelos

MegaRouter recomienda configurar primary como megarouter/auto.

Selecciona automáticamente el mejor modelo por precio, latencia y disponibilidad.

Usar un modelo específico

Para usar un modelo fijo, por ejemplo, establece primary como megarouter/deepseek/deepseek-v3.2

Preguntas frecuentes

1. Solo los modelos de OpenAI funcionan; los demás fallan

   Los modelos disponibles a través de MegaRouter usan el protocolo compatible con OpenAI. En los ajustes de integración de OpenClaw, configura el campo "api" aopenai-completions(como se muestra en los ejemplos anteriores). Si los modelos de la familia OpenAI funcionan, pero todos los demás fallan, comprueba laprovidersentrada: elapitipo.

2. Modelo no encontrado o respuesta vacía

   Confirma que la ortografía del ID del modelo es correcta; que el nombre configuradoprovidercoincida con el que mencionas; yreasoningdebe estar establecido enfalse.

Configuración de QClaw

Si ya tienes OpenClaw instalado, sigue los pasos siguientes para conectar MegaRouter.

Configurar en chat

1. En el chat, envía el mensaje siguiente. Reemplaza el valor de apiKey por tu clave API de MegaRouter.

Ayúdame a añadir un nuevo proveedor
Nombre: MegaRouter
apiKey: sk-or-v1-xxxxxxxxxxxxxxxx
baseUrl: https://api.megarouter.com/openai/v1
Modelos (puedes pasar varios): 1. auto 2. deepseek/deepseek-v3.2

QClaw añadirá el proveedor y se reiniciará automáticamente.

2. Verificar

Pregunta: “Ayúdame a verificar que mi configuración de MegaRouter funciona.” El asistente debería responder con algo como “¡Proveedor de MegaRouter agregado correctamente!” (la redacción exacta puede variar.)

3. Cambiar a MegaRouter

Pregunta: "Cambia a automático en MegaRouter". El asistente debe responder algo como "¡Cambiado correctamente!" (la redacción exacta puede variar).

Configuración de AutoClaw

1. Abre la entrada de configuración

Haz clic en Preferencias en la parte inferior izquierda, ve a Modelos y API y luego haz clic en Añadir modelo personalizado.

2. Añadir un modelo

• Establece el proveedor en Personalizado.
• Introduce un ID de modelo compatible con MegaRouter, p. ej. deepseek/deepseek-v3.2.
• Introduce nombre visible, p.ej. MegaRouter(deepseek-v3.2).
• Introduce tu clave de API, p. ej. sk-or-v1-xxxxxxxxxxxxxxxx.
• URL base: https://api.megarouter.com/openai/v1

3. Prueba la configuración

Haz clic en "Prueba de conexión". Si aparece "Prueba superada", la configuración es correcta.

4. Usa el modelo

• Haz clic en Añadir. Una vez guardado, vuelve a la app.
• Debajo del campo de entrada del chat, cambia el modelo al que tengas configuradoMegaRouter (deepseek-v3.2)para poder usarlo.

Configuración de Cursor

Si ya tienes Cursor instalado, sigue estos pasos para conectar MegaRouter.

1. Abre los ajustes de Cursor

Usar el menú en la esquina superior derecha → Ajustes.

2. Modelos

En la barra lateral izquierda:

• Modelos abiertos.
• Selecciona Ver todos los modelos, desplázate al final y luego agrega Modelo personalizado.
• Introduce el ID del modelo específico, p. ej. deepseek/deepseek-v3.2. No uses automático.

3. Añade MegaRouter

Configura el acceso a API:

• Expande Claves API.
• Pega tu clave API de MegaRouter.
• Establece la URL base en https://api.megarouter.com/openai/v1

4. Guarda y cierra la página de Ajustes.

5. Usa MegaRouter en Cursor

En Chat, Composer o Agent, selecciona tu modelo de MegaRouter en el menú desplegable de modelos.

Configuración de Hermes

Prerrequisitos

• Crear unClave APIen la consola de MegaRouter.
• Si usas el enrutamiento automático, actívalo en Ajustes → Enrutamiento en la consola.

Opción 1: Configuración de terminal

1. Elige modelo y endpoint personalizado

Ejecuta en tu terminal:

hermes model

En el menú, elige Endpoint personalizado y rellena los campos:

Si te piden la longitud de contexto, pulsa Enter para dejarlo en blanco (Hermes lo detectará).

2. (Opcional) Panel de web local

Para editar la configuración en el navegador, ejecuta:

hermes dashboard

3. Verifica

hermes chat "Hello"

El éxito significa que la solicitud ha llegado a MegaRouter y que el enrutamiento inteligente o el modelo que hayas elegido ha devuelto un resultado.

También puedes ejecutarhermes doctorpara verificar la conexión.

Opción 2: Edita archivos de configuración

1. Ubicaciones de archivos

macOS / Linux

• ~/.hermes/config.yaml, configuración principal (modelo, proveedor, URL base, clave API, etc.)
• ~/.hermes/.env, secretos y variables de entorno (recomendado)

Windows:

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

2. Guarda la clave API en.env(Elige uno)

Opción A (mismo nombre que MegaRouter)

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

Opción B (convención común de endpoint personalizado de Hermes)

simodel.api_keyno está configurado para un endpoint personalizado, Hermes recurre aOPENAI_API_KEY. Pon tu clave de MegaRouter aquí:

OPENAI_API_KEY=sk-or-v1_xxxxxxxxxxxxxxxxxxxxx

docs.hermes.m2s3ZhBeforeconfig.yamldocs.hermes.m2s3ZhMidmodel

Ruta automática (auto)

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

Si usas opción B, déjaloapi_keyen blanco o elimínalo para que Hermes lo useOPENAI_API_KEY.

Hermes se expande${VAR}al cargar la configuración (las variables deben existir en el entorno, generalmente de~/.hermes/.env).

Ejemplo de modelo fijo

El ID del modelo debe coincidir con lalista de modelos de MegaRouter.

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

4. Verifica después de guardar

Después de guardar, ejecutahermes chat "Hello"para verificar la conexión de MegaRouter.

Múltiples rutas / modelos

docs.hermes.multiSeg1autodocs.hermes.multiSeg2deepseek/deepseek-v3.2.docs.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

Cómo cambiar

1. Terminal: ejecutarhermes modelde nuevo y elige la ruta indicada o el endpoint personalizado.
2. En chat (TUI): usa la/modelsintaxis de la documentación de Hermes, por ejemplo:

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

(nombres siguencustom_providers[].name; el formato escustom:<profile name>:<model id>.)

Preguntas frecuentes

Referencia de API

Endpoints

Modelos

Formato del ID del modelo: provider/model-name. Los números de versión usan un punto (p. ej. 4.6), no un guion.

Para más modelos, visitaModelospágina

Solución de problemas