MegaRouterドキュメント

入門編

APIキーを作成

1. megarouter.comにアクセスし、ログイン方法を選択して、承認してください。
2. コンソール → 設定 → APIキー → キーを作成

2. 自動ルーティング（オプション）

自動ルーティングはデフォルトで有効になっています。制御するには:

コンソール → 設定 → ルーティング → 自動ルーティングトグル

有効化すると、MegaRouterは各リクエストに最適なモデルを自動的に選択します。モデルを自分で選びたい場合は、このステップをスキップして直接モデルを指定してください（例：anthropic/claude-sonnet-4.6）。

標準セットアップ

OpenAI APIと完全互換。Python、Node.js、curl、およびエコシステム全体のツールをサポート。

ベース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. ウェブコンソールを起動

ターミナルで実行：

openclaw dashboard

ブラウザはコンソールを開きます （通常http://127.0.0.1:18789). お手数ですが、ブラウザが自動的に開かない場合は、そのアドレスに手動でアクセスしてください。

2. 設定ページに移動してください。

Config → Rawモード

3. MegaRouterの設定を追加

envを追加し、MEGAROUTER_API_KEYをMegaRouter API Keyに設定してください：

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

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コンソール：右上の「保存」をクリックし、次に「更新」をクリックします。

5. 接続を確認

OpenClaw Chatで、テストメッセージ（例：「Hello」）を送信してください。設定が正しければ、MegaRouter APIが呼び出され→最適なモデルに自動ルーティングされ→レスポンスが返されます。

方法2：設定ファイルを編集

1. openclaw.json ファイルを見つけてください。

macOS：

Finderを開いてCommand + Shift + Gを押す

入力~/.openclaw

Enterキーを押して表示openclaw.json.

Windows：

パス：C:\Users\<YourUsername>\.openclaw\openclaw.json

2. MegaRouter設定を追加

envを追加し、MEGAROUTER_API_KEYをMegaRouter API Keyに設定してください：

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

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. 接続を確認

ローカル端末で以下を実行して、CLI会話を開始してください：

openclaw tui

または以下のコマンドを実行して、ブラウザでOpenClaw Chatを使用してください：

openclaw dashboard

オプション設定

自動モデルルーティング

MegaRouterは、primaryをmegarouter/autoに設定することを推奨します。

価格、レイテンシ、可用性に基づいて最適なモデルを自動で選択します。

特定のモデルを使用

固定モデルを使用する例：primaryをmegarouter/deepseek/deepseek-v3.2に設定

よくある質問

1. OpenAIモデルのみ成功、他のモデルは失敗

   MegaRouterで利用可能なモデルは、OpenAI互換プロトコルを使用します。OpenClaw統合設定で、apiフィールドをopenai-completions（上記の例のように）。OpenAIファミリーモデルが動作するが、他のすべてのモデルが失敗する場合は、チェックprovidersエントリー:api入力

2. モデル未検出または空の応答

   モデルIDのスペルが正しいことを確認してください；設定されたprovider名前が参照内容と一致、およびreasoning設定が必要false。

QClaw セットアップ

すでにOpenClawをインストール済みの場合は、以下の手順に従ってMegaRouterに接続してください。

チャットで設定

1. チャットで以下のメッセージを送信し、apiKeyの値をMegaRouter APIキーに置き換えてください。

新しいプロバイダーを追加
名前：
APIキー：
ベースURL：https://api.megarouter.com/openai/v1
モデル（複数指定可能）：1. 自動 2. deepseek/deepseek-v3.2

QClawはプロバイダーを追加し、自動的に再起動します。

2. 確認

質問：「MegaRouterの設定が正しく動作しているか確認させてください。」アシスタントは「MegaRouterプロバイダが正常に追加されました！」のような返答をします。（正確な表現は異なる場合があります。）

3. MegaRouterに切り替え

質問：「MegaRouterで自動に切り替えてください。」アシスタントは「切り替えました」のように返答します（正確な文言は異なる場合があります）。

AutoClaw 設定

1. 設定エントリを開いてください

左下の「設定」をクリックし、「モデルとAPI」に移動してから、「カスタムモデルを追加」をクリックしてください。

2. モデルを追加

• プロバイダーをCustomに設定してください。
• MegaRouter対応のモデルIDを入力してください（例：deepseek/deepseek-v3.2）
• 表示名を入力してください（例：MegaRouter(deepseek-v3.2)）。
• APIキーを入力してください（例：sk-or-v1-xxxxxxxxxxxxxxxx）
• ベースURL: https://api.megarouter.com/openai/v1

3. 設定をテスト

接続テストをクリックしてください。「Test successful」と表示されれば、設定は正しいです。

4. モデルを使用する

• 追加をクリックしてください。保存後、アプリに戻ってください。
• チャット入力の下で、モデルを設定済みのものに切り替えてください。MegaRouter（deepseek-v3.2）使用する

Cursor 設定

すでにCursorをインストールしている場合は、以下の手順に従ってMegaRouterに接続してください。

1. Cursorの設定を開いてください

右上のメニュー→設定

2. モデル

左側のサイドバー：

• オープンモデル
• 「すべてのモデルを表示」を選択し、一番下までスクロールして、「カスタムモデルを追加」をクリックしてください。
• 特定のモデルIDを入力してください（例：deepseek/deepseek-v3.2）。自動は使用しないでください。

3. MegaRouterを追加

APIアクセスの設定：

• APIキーを展開
• MegaRouter APIキーを貼り付けてください
• ベースURLを https://api.megarouter.com/openai/v1 に設定

4. 設定ページを保存して閉じてください。

5. CursorでMegaRouterを使用する

チャット、Composer、Agent で、モデルドロップダウンから MegaRouter モデルを選択してください。

Hermes 設定

前提条件

• 作成APIキーMegaRouter コンソール内
• 自動ルーティングを使用する場合は、コンソールの「設定」→「ルーティング」で有効にしてください。

オプション1: ターミナル設定

1. モデルとカスタムエンドポイントを選択

ターミナルで実行：

hermes model

メニューで「カスタムエンドポイント」を選択し、フィールドに入力してください。

コンテキストの長さを求められた場合は、Enterキーを押して空白のままにしてください（Hermesが検出します）

2. （オプション）ローカルWebダッシュボード

ブラウザで設定を編集するには、実行：

hermes dashboard

3. 確認

hermes chat "Hello"

成功とは、リクエストがMegaRouterに到達し、スマートルーティングまたは選択したモデルが結果を返したことを意味します。

実行も可能ヘルメス・ドクター接続を確認

オプション2：設定ファイルを編集

1. ファイルの場所

macOS / Linux

• ~/.hermes/config.yaml、メイン設定（モデル、プロバイダ、base_url、api_keyなど）
• ~/.hermes/.env、シークレットと環境変数（おすすめ）

Windows：

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

2. APIキーを保存してください.env（いずれか1つを選択）

オプションA（MegaRouterと同じ名前）

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

オプションB（一般的なHermesカスタムエンドポイント規約）

条件モデルAPIキーカスタムエンドポイント未設定時、HermesはフォールバックOPENAI_API_KEY. MegaRouterキーを設定：

OPENAI_API_KEY=sk-or-v1_xxxxxxxxxxxxxxxxxxxxx

docs.hermes.m2s3ZhBeforeconfig.yamldocs.hermes.m2s3ZhMidモデル

自動ルーティング(auto)

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

オプションB使用時は空白のままにしてくださいAPIキー空欄のままにするか削除すると、Hermesが使用されます。OPENAI_API_KEY.

ヘルメス拡大${VAR}設定読み込み時（変数は環境内に存在する必要があり、通常は~/.hermes/.env).

固定モデルの例

モデルIDは一致する必要がありMegaRouter モデル一覧.

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

4. 保存後に確認

保存後、実行hermes chat "Hello"MegaRouter接続を確認してください。

複数ルート/モデル

docs.hermes.multiSeg1自動docs.hermes.multiSeg2deepseek/deepseek-v3.2docs.hermes.multiSeg3config.yamldocs.hermes.multiSeg4カスタムプロバイダーdocs.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

切り替え方法

1. ターミナル：実行hermes model再度、名前付きルートまたはカスタムエンドポイントを選択
2. チャット（TUI）: 使用/modelHermesドキュメントの構文、例：

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

名前（以下）custom_providers[]の名前ソーステキスト： ; 形式はカスタム：<profile name>：<model id>.)

よくある質問

APIリファレンス

エンドポイント

モデル一覧

モデルID形式：provider/model-name。バージョン番号にはドット（例：4.6）を使用し、ハイフンは使用しません。

さらにモデルを見るには、モデル一覧ページ

トラブルシューティング