OpenClaw 接入 MiniMax MCP（中國版）完整設定指南｜Windows 專用攻略

前言

本篇記錄我在 OpenClaw 中設定 MiniMax MCP 的完整過程，特別針對中國版本的 API 環境（api.minimaxi.com）進行說明。整個過程花了不少時間踩坑，因此特別寫成攻略分享。

⚠️ 本篇適用於 Windows 用戶 — 若你是 macOS / Linux 用戶，請參考[另一篇攻略（待補）]。

---

環境確認

• OpenClaw 版本：2026.5.4
• 作業系統：Windows 11 (NT 10.0.26100)
• Node.js：v24.14.1
• 套件管理器：uvx (uv 0.10.9)
• MiniMax API 版本：中國版（api.minimaxi.com）

---

前置準備

1. 確認 MiniMax 訂閱方案

MiniMax MCP 的 Web Search 功能需要 Plus 等級才能使用（49元/月）。

💡 確認你的 API Key 還有效，可以到 MiniMax 開發者平臺 檢查。

2. 確認 uvx 已安裝

uvx --version
# 輸出：uvx 0.10.9 (f675560f3 2026-03-06)

如果未安裝，可以參考 uv 官方安裝方式。

---

設定流程

Step 1：確認 OpenClaw MCP 指令可用

openclaw mcp --help

應該看到以下輸出：

Manage OpenClaw MCP config and channel bridge

Commands:
  list   List configured MCP servers
  serve  Expose OpenClaw channels over MCP stdio
  set    Set one configured MCP server from a JSON object
  show   Show one configured MCP server or the full MCP config
  unset  Remove one configured MCP server

Step 2：確認目前的 MCP 設定

openclaw mcp list

一開始應該是空的：

No MCP servers configured in C:\Users\your_user\.openclaw\openclaw.json.

Step 3：準備 MCP 設定檔（Windows PowerShell 專用）

使用 openclaw config patch 指令來寫入設定（繞過 PowerShell 的 JSON 轉義問題）。

💡 為什麼不用 openclaw mcp set？ 因為 PowerShell 對 JSON 中的引號處理會造成轉義錯誤，config patch --file 可以繞過這個問題。

首先，建立一個 JSON 檔案 mcp_patch.json：

{
  "mcp": {
    "servers": {
      "minimax-coding-plan-mcp": {
        "command": "uvx",
        "args": ["minimax-coding-plan-mcp"],
        "env": {
          "MINIMAX_API_KEY": "你的_API_KEY",
          "MINIMAX_API_HOST": "https://api.minimaxi.com"
        }
      }
    }
  }
}

⚠️ 重要：這裡使用的是 MINIMAXAPIHOST 而不是 MINIMAXAPIBASE_URL，否則會報 2049 錯誤。

Step 4：寫入設定

openclaw config patch --file .\mcp_patch.json

成功後會看到：

Config overwrite: C:\Users\your_user\.openclaw\openclaw.json
Applied 4 config update(s). Restart the gateway to apply.

Step 5：確認設定已寫入

openclaw mcp list

應該看到：

MCP servers (C:\Users\your_user\.openclaw\openclaw.json):
- minimax-coding-plan-mcp

Step 6：重啟 Gateway

openclaw gateway restart

這一步非常重要，否則 MCP 模組不會被載入。

Step 7：驗證功能

使用 mcporter 測試 Web Search 是否正常：

mcporter call minimax-coding-plan-mcp.web_search query="測試"

成功的話會回傳搜尋結果。

---

常見問題與解決方案

Q1：API Key 顯示 401 Unauthorized

原因：API Key 已過期或無效。

解決：

1. 到 MiniMax 開發者平臺 重新產生 API Key
2. 確認你的訂閱方案是否為 Plus 等級
3. 確認 API Key 不是中國區 (.com) vs 國際區 (.io) 的格式問題

Q2：MCP 設定已寫入，但 openclaw mcp list 看不到

原因：Gateway 尚未重啟。

解決：執行 openclaw gateway restart

Q3：PowerShell 執行 openclaw mcp set 時 JSON 解析錯誤

原因：PowerShell 的引號處理會破壞 JSON 字串。

解決：使用 openclaw config patch --file 代替 openclaw mcp set。

Q4：使用 minimax-coding-plan-mcp 時得到 2049 錯誤

原因：環境變數名稱錯誤。

解決：確認使用 MINIMAXAPIHOST 而非其他名稱，例如：

• ✅ MINIMAXAPIHOST=https://api.minimaxi.com
• ❌ MINIMAXAPIBASE_URL=https://api.minimaxi.com

Q5：mcporter 與 openclaw mcp 的區別（Windows 特別注意事項）

mcporter：

• 獨立的 MCP 包裝工具
• 設定檔在 ~/.openclaw/workspace/config/mcporter.json
• 適合用來測試 MCP 工具
• ⚠️ Windows 上需注意路徑格式（建議使用絕對路徑）

openclaw mcp：

• OpenClaw 內建的 MCP 管理指令
• 設定檔在 openclaw.json 的 mcp.servers 區塊
• 適合 OpenClaw 整合使用
• ⚠️ PowerShell 環境建議用 config patch --file 取代 mcp set

---

設定完成後的模組結構

openclaw.json
├── mcp:
│   └── servers:
│       └── minimax-coding-plan-mcp:
│           ├── command: "uvx"
│           ├── args: ["minimax-coding-plan-mcp"]
│           └── env:
│               ├── MINIMAX_API_KEY: "***"
│               └── MINIMAX_API_HOST: "https://api.minimaxi.com"

---

可用的 MiniMax MCP 工具

工具名稱	用途
web_search	網頁搜尋
understand_image	圖片理解

---

結論（Windows 用戶）

這次設定的重點（Windows 版）：

1. 使用 openclaw config patch --file 繞過 PowerShell 的 JSON 轉義問題
2. 確認 API Key 有效，特別是中國版的 endpoint (api.minimaxi.com)
3. 記得重啟 Gateway，否則設定不會生效
4. PowerShell 使用者請特別注意路徑格式與引號轉義問題

希望這篇攻略能幫助大家快速完成設定！

---

參考資源：

• MiniMax 開發者平臺
• MiniMax MCP 官方文檔
• OpenClaw 官方文檔
• uv 安裝腳本：https://astral.sh/uv/install.sh