MegaRouter-Dokumentation

Erste Schritte

API-Schlüssel erstellen

1. Megarouter.com aufrufen, Anmeldemethode wählen und autorisieren
2. Gehen Sie zu Konsole → Einstellungen → API-Schlüssel → Schlüssel erstellen

2. Auto Routing (optional)

Auto-Routing ist standardmäßig aktiviert. Zur Steuerung:

Konsole → Einstellungen → Routing → Auto-Routing

Nach der Aktivierung wählt MegaRouter automatisch das beste Modell für jede Anfrage aus. Wenn Sie Modelle lieber selbst auswählen möchten, überspringen Sie diesen Schritt und geben Sie die Modelle direkt an (z. B. anthropic/claude-sonnet-4.6).

Standard-Setup

Vollständig kompatibel mit der OpenAI API. Unterstützt Python, Node.js, curl und Tools aus dem gesamten Ökosystem.

Ersetzen Sie die Basis-URL ( https://api.megarouter.com/openai/v1 ) und den API-Schlüssel, um es zu nutzen.

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 Setup

Wenn Sie OpenClaw bereits installiert haben, folgen Sie den unten stehenden Schritten, um MegaRouter zu verbinden.

MegaRouter verbinden

Methode 1: Web-Konsole

1. Web-Konsole starten

Im Terminal ausführen:

openclaw dashboard

Der Browser öffnet die Konsole (normalerweisehttp://127.0.0.1:18789). Falls der Browser nicht automatisch geöffnet wird, besuchen Sie diese Adresse bitte manuell.

2. Gehen Sie zur Konfigurationsseite

Konfiguration → Rohmodus auswählen

3. MegaRouter-Konfiguration hinzufügen

Bitte fügen Sie eine Umgebungsvariable hinzu und setzen Sie MEGAROUTER_API_KEY auf Ihren MegaRouter-API-Schlüssel:

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

Modelle mit baseUrl https://api.megarouter.com/openai/v1: hinzufügen

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

Ersetzen Sie den ursprünglichen Abschnitt "agents": {...} durch:

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

4. Konfiguration speichern und anwenden

Web-Konsole: Klicken Sie oben rechts auf Speichern, dann auf Aktualisieren.

5. Verbindung prüfen

Senden Sie im OpenClaw Chat eine Testnachricht wie „Hello“. Bei korrekter Konfiguration wird die MegaRouter API aufgerufen → automatisch an das beste Modell weitergeleitet → die Antwort zurückgegeben.

Methode 2: Konfigurationsdatei bearbeiten

1. Suchen Sie die Datei openclaw.json.

macOS:

Finder öffnen, Befehl + Umschalt + G drücken

Eingabe:~/.openclaw

Enter drücken, um anzuzeigenopenclaw.json.

Windows:

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

2. MegaRouter-Konfiguration hinzufügen

Bitte fügen Sie eine Umgebungsvariable hinzu und setzen Sie MEGAROUTER_API_KEY auf Ihren MegaRouter-API-Schlüssel:

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

Modelle mit baseUrl https://api.megarouter.com/openai/v1: hinzufügen

"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
        }
      ]
    }
  }
},

Ersetzen Sie den ursprünglichen Abschnitt "agents": {...} durch:

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

3. Konfiguration speichern und überprüfen

Bitte führen Sie nach dem Speichern der Konfigurationsdatei Folgendes in einem Terminal aus, um die Datei anzuzeigen und zu bestätigen, dass sie korrekt ist:

cat ~/.openclaw/openclaw.json

4. Verbindung prüfen

Führen Sie den folgenden Befehl in einem lokalen Terminal aus, um eine CLI-Konversation zu starten:

openclaw tui

Oder führen Sie Folgendes aus, um OpenClaw Chat im Browser zu verwenden:

openclaw dashboard

Optionale Konfiguration

Auto-Modellrouting

MegaRouter empfiehlt, primary auf megarouter/auto zu setzen.

Wählt automatisch das beste Modell basierend auf Preis, Latenz und Verfügbarkeit.

Bestimmtes Modell verwenden

Um ein festes Modell zu verwenden, setzen Sie z. B. das primäre Modell auf megarouter/deepseek/deepseek-v3.2

FAQ

1. Nur OpenAI-Modelle sind erfolgreich; andere Modelle schlagen fehl

   Über MegaRouter verfügbare Modelle verwenden das OpenAI-kompatible Protokoll. Setzen Sie in den OpenClaw-Integrationseinstellungen das API-Feld aufopenai-completions(wie in den obigen Beispielen). Wenn Modelle der OpenAI-Familie funktionieren, alle anderen jedoch fehlschlagen, überprüfen Sie denprovidersEintrag: denapiTyp.

2. Modell nicht gefunden oder leere Antwort

   Bestätigen Sie, dass die Schreibweise der Modell-ID korrekt ist; die konfigurierteproviderName entspricht Ihrer Referenz; undreasoningmuss auf gesetzt werdenfalse.

QClaw Setup

Wenn Sie bereits OpenClaw installiert haben, folgen Sie den unten stehenden Schritten, um MegaRouter zu verbinden.

Im Chat konfigurieren

1. Senden Sie im Chat die folgende Nachricht. Ersetzen Sie den apiKey-Wert durch Ihren MegaRouter-API-Schlüssel.

Neuen Anbieter hinzufügen
Name: MegaRouter
apiKey: sk-or-v1-xxxxxxxxxxxxxxxx
baseUrl: https://api.megarouter.com/openai/v1
Modelle (Sie können mehrere angeben): 1. Auto 2. deepseek/deepseek-v3.2

QClaw wird den Anbieter hinzufügen und automatisch neu starten.

2. Verifizieren

Fragen Sie: „Helfen Sie mir zu überprüfen, ob meine MegaRouter-Konfiguration funktioniert.“ Der Assistent sollte etwa mit „MegaRouter-Anbieter wurde erfolgreich hinzugefügt!“ antworten. (Der genaue Wortlaut kann variieren.)

3. Wechseln zu MegaRouter

Fragen Sie: „Switch to auto under MegaRouter.“ Der Assistent sollte etwa mit „Switched successfully!“ antworten. (Der genaue Wortlaut kann abweichen.)

AutoClaw Setup

1. Öffnen Sie den Konfigurationseintrag

Bitte klicken Sie unten links auf „Einstellungen“, gehen Sie zu „Modelle & API“ und klicken Sie dann auf „Eigenes Modell hinzufügen“.

2. Modell hinzufügen

• Setzen Sie den Provider auf Custom.
• Geben Sie eine von MegaRouter unterstützte Modell-ID ein, z. B. deepseek/deepseek-v3.2.
• Geben Sie einen Anzeigenamen ein, z. B. MegaRouter(deepseek-v3.2).
• Geben Sie Ihren API-Key ein, z. B. sk-or-v1-xxxxxxxxxxxxxxxx.
• Base URL: https://api.megarouter.com/openai/v1

3. Konfiguration testen

Klicken Sie auf den Verbindungstest. Wenn Sie „Test erfolgreich“ sehen, ist die Einrichtung korrekt.

4. Modell verwenden

• Klicken Sie auf Hinzufügen. Kehren Sie nach dem Speichern zur App zurück.
• Unterhalb des Chat-Eingabefelds wechseln Sie das Modell zu Ihrem konfigurierten Modell,MegaRouter(deepseek-v3.2)um es zu verwenden.

Cursor Setup

Wenn Sie bereits Cursor installiert haben, folgen Sie diesen Schritten, um MegaRouter zu verbinden.

1. Cursor-Einstellungen öffnen

Verwenden Sie das Menü oben rechts → Einstellungen.

2. Modelle

In der linken Seitenleiste:

• Open Models.
• Bitte wählen Sie „Alle Modelle anzeigen“, scrollen Sie nach unten und klicken Sie dann auf „Benutzerdefiniertes Modell hinzufügen“.
• Geben Sie die spezifische Modell-ID ein, z. B. deepseek/deepseek-v3.2. Verwenden Sie nicht Auto.

3. MegaRouter hinzufügen

API-Zugriff konfigurieren:

• API-Schlüssel erweitern.
• Fügen Sie Ihren MegaRouter-API-Schlüssel ein.
• Basis-URL auf https://api.megarouter.com/openai/v1 setzen

4. Bitte speichern und schließen Sie die Seite „Einstellungen“.

5. MegaRouter in Cursor verwenden

Wählen Sie in Chat, Composer oder Agent Ihr MegaRouter-Modell aus dem Modell-Dropdown.

Hermes Setup

Voraussetzungen

• ErstellenAPI-Keyin der MegaRouter-Konsole.
• Wenn Sie Auto-Routing verwenden, aktivieren Sie es unter Einstellungen → Routing in der Konsole.

Option 1: Terminal-Setup

1. Modell und benutzerdefinierten Endpunkt auswählen

Im Terminal ausführen:

hermes model

Wählen Sie im Menü den benutzerdefinierten Endpunkt aus und füllen Sie die Felder aus:

Wenn Sie nach der Kontextlänge gefragt werden, drücken Sie die Eingabetaste, um das Feld leer zu lassen (Hermes erkennt es).

2. (Optional) Lokales Web-Dashboard

Um die Konfiguration im Browser zu bearbeiten, führen Sie Folgendes aus:

hermes dashboard

3. Bestätigen

hermes chat "Hello"

Erfolg bedeutet, dass die Anfrage MegaRouter erreicht hat und Smart-Routing oder Ihr ausgewähltes Modell ein Ergebnis zurückgegeben hat.

Auch ausführenHermes Doctorzur Überprüfung der Verbindung

Option 2: Konfigurationsdateien bearbeiten

1. Dateiorte

macOS / Linux

• ~/.hermes/config.yaml, Hauptkonfiguration (model, provider, base_url, api_key, usw.)
• ~/.hermes/.env, Secrets und Umgebungsvariablen (empfohlen)

Windows:

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

2. API-Schlüssel speichern in.env(wählen Sie eine Option)

Option A (gleicher Name wie MegaRouter)

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

Option B (gängige Hermes-Custom-Endpunkt-Konvention)

Wennmodel.api_keyOhne benutzerdefinierten Endpunkt greift Hermes zurück aufOPENAI_API_KEY. Geben Sie hier Ihren MegaRouter-Schlüssel ein:

OPENAI_API_KEY=sk-or-v1_xxxxxxxxxxxxxxxxxxxxx

docs.hermes.m2s3ZhBeforeconfig.yamldocs.hermes.m2s3ZhMidModell

Auto-Routing (Auto)

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

Bei Option B leer lassenAPI-SchlüsselLeer lassen/entfernen – Hermes verwendetOPENAI_API_KEY.

Hermes erweitert${VAR}beim Laden der Konfiguration (Variablen müssen in der Umgebung vorhanden sein, normalerweise von~/.hermes/.env).

Festes Modellbeispiel

Die Modell-ID muss mit derMegaRouter Modellliste.

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

4. Nach dem Speichern überprüfen

Nach dem Speichern ausführenhermes chat "Hello"um die MegaRouter-Verbindung zu überprüfen.

Mehrere Routen / Modelle

docs.hermes.multiSeg1Autodocs.hermes.multiSeg2deepseek/deepseek-v3.2docs.hermes.multiSeg3config.yamldocs.hermes.multiSeg4Benutzerdefinierte Anbieterdocs.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

So wechseln Sie

1. Terminal: runHermes-Modellerneut und die benannte Route oder den Custom-Endpunkt auswählen.
2. Im Chat (TUI): verwenden/modelSyntax aus der Hermes-Dokumentation, z. B.:

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

(Namen folgen)custom_providers[].name; Format istbenutzerdefiniert:<profile name>:<model id>.)

FAQ

API-Referenz

Endpunkte

Modelle

Modell-ID-Format: Anbieter/Modellname. Versionsnummern verwenden . (z. B. 4.6), nicht -.

Für weitere Modelle besuchen SieModelleSeite.

Fehlerbehebung