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 Key。只需對四個 provider 任選其一執行一次以下指令即可——外掛透過 providerAuthAliases 讓同一把 key 同時生效到全部 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 hook 自動路由到對應 transport，不需要寫完整 provider/model。

不想走互動式登入：先 export AIHUBMIX_API_KEY=sk-... 再 install，外掛會把 key 作為 inline apiKey 寫入 provider 設定（互動式登入則由 SDK 存入 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 "只回覆 OK"

如果需要呼叫非 OpenAI / Claude / Gemini 分組的模型，可使用 aihubmix-other，例如：

openclaw infer model run --local --json --model aihubmix-other/glm-5.2 --prompt "只回覆 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 整合

Agent / Workflow

SDK 與框架

OpenClaw

安裝

終端機設定

設定 AIHubMix

方法 1:透過外掛快速設定(推薦)

方法 2:手動設定

方法 3：使用動態模型命令切換預設模型

啟動

測試

常見問題

版本升級

Gateway 處理程序被佔用

​安裝

​終端機設定

​設定 AIHubMix

​方法 1:透過外掛快速設定(推薦)

​方法 2:手動設定

​方法 3：使用動態模型命令切換預設模型

​啟動

​測試

​常見問題

​版本升級

​Gateway 處理程序被佔用

安裝

終端機設定

設定 AIHubMix

方法 1:透過外掛快速設定(推薦)

方法 2:手動設定

方法 3：使用動態模型命令切換預設模型

啟動

測試

常見問題

版本升級

Gateway 處理程序被佔用