> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MiniMax 搜尋

OpenClaw 透過 MiniMax Token Plan 搜尋 API，支援將 MiniMax 作為 `web_search` 提供者。它會傳回包含標題、URL、摘要片段和相關查詢的結構化搜尋結果。

## 取得 Token Plan 憑證

<Steps>
  <Step title="建立金鑰">
    從
    [MiniMax Platform](https://platform.minimax.io/user-center/basic-information/interface-key)
    建立或複製 MiniMax Token Plan 金鑰。
    OAuth 設定可以改用 `MINIMAX_OAUTH_TOKEN`。
  </Step>

  <Step title="儲存金鑰">
    在閘道環境中設定 `MINIMAX_CODE_PLAN_KEY`，或透過以下方式設定：

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw configure --section web
    ```
  </Step>
</Steps>

OpenClaw 也接受 `MINIMAX_CODING_API_KEY`、`MINIMAX_OAUTH_TOKEN` 和
`MINIMAX_API_KEY` 作為環境別名，會在 `MINIMAX_CODE_PLAN_KEY` 之後依此順序檢查。`MINIMAX_API_KEY` 應指向已啟用搜尋的
Token Plan 憑證；一般 MiniMax 模型 API 金鑰可能不會被 Token Plan 搜尋端點接受。

## 設定

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  plugins: {
    entries: {
      minimax: {
        config: {
          webSearch: {
            apiKey: "sk-cp-...", // optional if a MiniMax Token Plan env var is set
            region: "global", // or "cn"
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "minimax",
      },
    },
  },
}
```

**環境替代方式：** 在閘道環境中設定 `MINIMAX_CODE_PLAN_KEY`、`MINIMAX_CODING_API_KEY`、
`MINIMAX_OAUTH_TOKEN` 或 `MINIMAX_API_KEY`。
若是閘道安裝，請將它放在 `~/.openclaw/.env`。

## 區域選擇

MiniMax Search 使用這些端點：

* 全球：`https://api.minimax.io/v1/coding_plan/search`
* 中國：`https://api.minimaxi.com/v1/coding_plan/search`

如果未設定 `plugins.entries.minimax.config.webSearch.region`，OpenClaw 會依以下順序解析區域：

1. `tools.web.search.minimax.region` / 外掛擁有的 `webSearch.region`
2. `MINIMAX_API_HOST`
3. `models.providers.minimax.baseUrl`
4. `models.providers.minimax-portal.baseUrl`

這表示中國區上線設定或 `MINIMAX_API_HOST=https://api.minimaxi.com/...`
也會自動讓 MiniMax Search 使用中國區主機。

即使你是透過 OAuth `minimax-portal` 路徑驗證 MiniMax，網頁搜尋仍會註冊為提供者 ID `minimax`；OAuth 提供者基底 URL
會作為中國區/全球主機選擇的區域提示，而 `MINIMAX_OAUTH_TOKEN`
可以滿足 MiniMax Search 的 Bearer 憑證需求。

## 支援的參數

| 參數      | 類型      | 限制條件      | 說明                              |
| ------- | ------- | --------- | ------------------------------- |
| `query` | string  | 必填        | 搜尋查詢字串。                         |
| `count` | integer | 1-10，預設 5 | 要傳回的結果數量。OpenClaw 會將傳回清單裁切為此大小。 |

目前不支援提供者專屬篩選條件。

## 相關

* [網頁搜尋概覽](/zh-TW/tools/web) -- 所有提供者與自動偵測
* [MiniMax](/zh-TW/providers/minimax) -- 模型、圖片、語音與驗證設定