> ## 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="存储密钥">
    在 Gateway 网关环境中设置 `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",
      },
    },
  },
}
```

\*\*环境变量替代方式：\*\*在 Gateway 网关环境中设置 `MINIMAX_CODE_PLAN_KEY`、`MINIMAX_CODING_API_KEY`、`MINIMAX_OAUTH_TOKEN` 或 `MINIMAX_API_KEY`。
对于 Gateway 网关安装，请将其放入 `~/.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 认证，Web 搜索仍会注册为提供商 ID `minimax`；OAuth 提供商 base URL 会作为中国大陆/全球主机选择的区域提示，并且 `MINIMAX_OAUTH_TOKEN` 可以满足 MiniMax Search bearer 凭证要求。

## 支持的参数

| 参数      | 类型  | 约束        | 描述                              |
| ------- | --- | --------- | ------------------------------- |
| `query` | 字符串 | 必填        | 搜索查询字符串。                        |
| `count` | 整数  | 1-10，默认 5 | 要返回的结果数量。OpenClaw 会将返回列表截断到此大小。 |

目前不支持提供商特定的过滤器。

## 相关

* [Web 搜索概览](/zh-CN/tools/web) -- 所有提供商和自动检测
* [MiniMax](/zh-CN/providers/minimax) -- 模型、图像、语音和认证设置