# MiniMax 搜索

> 通过 Token Plan 搜索 API 使用 MiniMax 搜索

- 网址：https://funcoding.ai/agents/openclaw/tools/minimax-search/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/tools/minimax-search

---
OpenClaw 通过 MiniMax Token Plan 搜索 API 支持将 MiniMax 用作 `web_search` 提供商。它返回包含标题、URL、摘要和相关查询的结构化搜索结果。

## 获取 Token Plan 凭证

**创建密钥**

从 [MiniMax Platform](https://platform.minimax.io/user-center/basic-information/interface-key)
创建或复制 MiniMax Token Plan 密钥。
OAuth 设置可改为复用 `MINIMAX_OAUTH_TOKEN`。

**存储密钥**

在 Gateway 网关环境中设置 `MINIMAX_CODE_PLAN_KEY`，或通过以下命令配置：

```bash
openclaw configure --section web
```

OpenClaw 还接受 `MINIMAX_CODING_API_KEY`、`MINIMAX_OAUTH_TOKEN` 和
`MINIMAX_API_KEY` 作为环境变量别名，并在
`MINIMAX_CODE_PLAN_KEY` 之后按此顺序检查。`MINIMAX_API_KEY` 应指向已启用搜索功能的
Token Plan 凭证；Token Plan 搜索端点可能不接受普通的 MiniMax 模型 API 密钥。

## 配置

```json5
{
  plugins: {
    entries: {
      minimax: {
        config: {
          webSearch: {
            apiKey: "sk-cp-...", // 如果已设置 MiniMax Token Plan 环境变量，则可选
            region: "global", // 或 "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 搜索使用以下端点：

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

如果未设置 `plugins.entries.minimax.config.webSearch.region`，OpenClaw 将按以下顺序解析区域：

1. 插件拥有的 `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 搜索使用中国区主机。

即使通过 OAuth `minimax-portal` 路径对 MiniMax 进行了身份验证，
Web 搜索仍会注册为提供商 ID `minimax`；OAuth 提供商的基础 URL
将用作选择中国区/全球主机的区域提示，而 `MINIMAX_OAUTH_TOKEN`
可满足 MiniMax 搜索对 Bearer 凭证的要求。

## 支持的参数

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

目前不支持提供商特定的筛选条件。

## 相关内容

- [Web 搜索概览](https://funcoding.ai/agents/openclaw/tools/web/) -- 所有提供商和自动检测
- [MiniMax](https://funcoding.ai/agents/openclaw/providers/minimax/) -- 模型、图像、语音和身份验证设置