AiHubMix Documentation Hub

インストール

インストール前に Node >= 22 であることを確認してください。

インストールコマンドを実行します。

npm install -g openclaw@latest

インストール後、以降のコマンドは任意のディレクトリから実行できます。先に OpenClaw のインストール先へ移動する必要はありません。ターミナルが openclaw を認識する場合は、このガイドのコマンドをそのままコピーして実行できます。

openclaw models status

Windows で openclaw が見つからないと表示される場合は、コマンド先頭の openclaw をローカルの実行ファイルパスに置き換えてください。

& "インストール先のパス\OpenClaw\openclaw.cmd" models status

インストール先のパス はプレースホルダーです。実際に OpenClaw を配置した親ディレクトリに置き換えてください。たとえば OpenClaw が D:\Apps\OpenClaw にある場合は、& "D:\Apps\OpenClaw\openclaw.cmd" models status と書きます。

ターミナル設定

ターミナルを開き、以下のコマンドを実行して設定を開始します。

openclaw onboard

Yes を選びます。

QuickStart を選びます。

Skip for now を選びます。

All providers を選びます。

必要に応じてデフォルトモデルを選択してください。最初は Keep current を選択できます（「方法 2：手動設定」を使用する場合、次の手順で設定ファイルから変更できます）。

必要に応じて個人アカウントをリンクしてください。不要な場合は Skip for now を選びます。

スキルを設定するには Yes を選びます。

npm を選びます。

必要に応じてスキルを選択して設定します。

すべてのオプションで No を選びます。

Skip for now を選びます。

Hatch in UI を選びます。

AIHubMix の設定

方法 1：プラグインによるクイック設定（推奨）

プラグインのソースコード：aihubmix-auth

AIHubMix auth プラグインをインストールし、Gateway を再起動します：

openclaw plugins install @akakenle/aihubmix-auth
openclaw gateway restart

auth コマンドを実行します。プロンプトが表示されたら AIHubMix の API キーを入力します。以下のコマンドは 4 つの provider のいずれか 1 つに対して一度だけ実行すれば OK です — プラグインは providerAuthAliases を使用して、同じキーをすべての transport で有効にします：

openclaw models auth login --provider aihubmix-openai --method api-key --set-default

プラグインはモデルを以下のグループに整理します：

aihubmix-openai — gpt-* / o1-* / o3-* / o4-*, https://aihubmix.com/v1 (openai-completions)
aihubmix-anthropic — claude-*, https://aihubmix.com (anthropic-messages)
aihubmix-google — gemini-*, https://aihubmix.com/gemini/v1beta (google-generative-ai)
aihubmix-other — その他のモデル, https://aihubmix.com/v1 (openai-completions)

省略形のモデル ID（例：claude-sonnet-4-5）は、プラグインの resolveDynamicModel フックによって自動的に正しい transport にルーティングされます — 完全な provider/model を書く必要はありません。

インタラクティブなログインをスキップしたい場合：インストール前に export AIHUBMIX_API_KEY=sk-... を設定してください — プラグインはキーを provider 設定のインライン apiKey として書き込みます（インタラクティブなログインは代わりに auth-profile に保存します）。

設定が完了したら、起動セクションに進んで使用を開始してください。

方法 2：手動設定

~/.openclaw/openclaw.json ファイルを開き、以下の設定を追加します：

{
  "models": {
    "mode": "merge",
    "providers": {
      "aihubmix-openai": {
        "baseUrl": "https://aihubmix.com/v1",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-4o",
            "name": "gpt-4o",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 16384
          }
        ]
      },
      "aihubmix-anthropic": {
        "baseUrl": "https://aihubmix.com",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-4-5",
            "name": "claude-sonnet-4-5",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 64000
          }
        ]
      },
      "aihubmix-google": {
        "baseUrl": "https://aihubmix.com/gemini/v1beta",
        "api": "google-generative-ai",
        "models": []
      },
      "aihubmix-other": {
        "baseUrl": "https://aihubmix.com/v1",
        "api": "openai-completions",
        "models": []
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "aihubmix-anthropic/claude-sonnet-4-5"
      },
      "workspace": "your_workspace_path",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
}

方法 3：動的モデルコマンドでデフォルトモデルを切り替える

AIHubMix の OpenClaw プラグインは動的モデルルーティングに対応しています。AIHubMix アカウントで利用可能なモデルであれば、provider/model-id 形式で呼び出せます。実際に利用できるモデルは、AIHubMix コンソールと API の応答を基準にしてください。よく使う provider の選び方は次の通りです。

aihubmix-openai：OpenAI 互換モデル。例：gpt-*、o1-*、o3-*、o4-*
aihubmix-anthropic：Claude モデル。例：claude-*
aihubmix-google：Gemini モデル。例：gemini-*
aihubmix-other：OpenAI 互換エンドポイント経由で呼び出すその他のモデル。例：glm-5.2

例として、gpt-5.4 を OpenClaw のデフォルトモデルに設定します。

openclaw models set aihubmix-openai/gpt-5.4

Windows で openclaw が見つからない場合は、ローカルパスの形式で実行します。

& "インストール先のパス\OpenClaw\openclaw.cmd" models set aihubmix-openai/gpt-5.4

現在のデフォルトモデルと認証状態を確認します。

openclaw models status

実際の呼び出しで確認します。

openclaw infer model run --local --json --model aihubmix-openai/gpt-5.4 --prompt "Reply only OK"

OpenAI / Claude / Gemini 以外のグループのモデルを呼び出す場合は、aihubmix-other を使います。例：

openclaw infer model run --local --json --model aihubmix-other/glm-5.2 --prompt "Reply only OK"

OpenClaw が現在読み込んでいるモデルカタログを確認します。

openclaw infer model list --json

起動

openclaw gateway

テスト

チャットページで hello と入力します。返信があれば設定は成功です。

よくある質問

バージョンアップグレード

openclaw plugins update @akakenle/aihubmix-auth
openclaw gateway restart

Gateway プロセスが使用中の場合

openclaw gateway stop
openclaw gateway

最終更新日：2026-07-03

コーディングアシスタント

IDE 統合

エージェント / ワークフロー

SDK とフレームワーク

OpenClaw

インストール

ターミナル設定

AIHubMix の設定

方法 1：プラグインによるクイック設定（推奨）

方法 2：手動設定

方法 3：動的モデルコマンドでデフォルトモデルを切り替える

起動

テスト

よくある質問

バージョンアップグレード

Gateway プロセスが使用中の場合

​インストール

​ターミナル設定

​AIHubMix の設定

​方法 1：プラグインによるクイック設定（推奨）

​方法 2：手動設定

​方法 3：動的モデルコマンドでデフォルトモデルを切り替える

​起動

​テスト

​よくある質問

​バージョンアップグレード

​Gateway プロセスが使用中の場合

インストール

ターミナル設定

AIHubMix の設定

方法 1：プラグインによるクイック設定（推奨）

方法 2：手動設定

方法 3：動的モデルコマンドでデフォルトモデルを切り替える

起動

テスト

よくある質問

バージョンアップグレード

Gateway プロセスが使用中の場合