Appearance
本页介绍如何将 OpenClaw 的 web_search 工具接入 MiniMax Coding Plan 搜索 API,返回含标题、URL、摘要和相关查询的结构化搜索结果。支持国内(minimaxi.com)和国际(minimax.io)双端点,区域自动从已配置的 MiniMax 模型 Provider 推断,无需单独设置。
MiniMax 网页搜索
OpenClaw 通过 MiniMax Coding Plan 搜索 API 支持 MiniMax 作为 web_search Provider,返回含标题、URL、摘要和相关查询的结构化搜索结果。
获取 Coding Plan Key
- 在 MiniMax Platform 创建或复制 MiniMax Coding Plan Key
- 设置环境变量
MINIMAX_CODE_PLAN_KEY,或通过交互式配置:
bash
openclaw configure --section web也支持 MINIMAX_CODING_API_KEY 作为环境变量别名;已有 Coding Plan Token 的 MINIMAX_API_KEY 作为兼容回退仍然有效。
配置
json5
{
plugins: {
entries: {
minimax: {
config: {
webSearch: {
apiKey: "sk-cp-...", // 已设置 MINIMAX_CODE_PLAN_KEY 时可省略
region: "global", // 或 "cn"
},
},
},
},
},
tools: {
web: {
search: {
provider: "minimax",
},
},
},
}也可直接在 Gateway 环境中设置 MINIMAX_CODE_PLAN_KEY;Gateway 部署可写入 ~/.openclaw/.env。
区域选择
MiniMax 搜索端点:
- 国际区:
https://api.minimax.io/v1/coding_plan/search - 国内区:
https://api.minimaxi.com/v1/coding_plan/search
未配置 region 时,OpenClaw 按以下顺序自动推断:
plugins.entries.minimax.config.webSearch.regionMINIMAX_API_HOSTmodels.providers.minimax.baseUrlmodels.providers.minimax-portal.baseUrl
这意味着国内 onboarding 或 MINIMAX_API_HOST=https://api.minimaxi.com/... 会自动让搜索也使用国内端点。
即使通过 OAuth minimax-portal 方式认证,网页搜索的 Provider ID 仍然是 minimax;OAuth Provider Base URL 仅用于推断国内/国际区域。
支持的参数
query:搜索关键词count:返回结果数量(OpenClaw 会裁剪到请求数)
目前不支持 Provider 特有的筛选器。
延伸阅读
常见问题
Q: MiniMax Coding Plan Key 和普通 MiniMax API Key 是同一个吗?
A: 不是。MINIMAX_CODE_PLAN_KEY(或 MINIMAX_CODING_API_KEY)是专门用于 Coding Plan 服务的 Key,在 MiniMax Platform 的"接口密钥"页面单独创建。如果你已有 MINIMAX_API_KEY,只有当它恰好指向一个 Coding Plan Token 时才会作为兼容回退被读取。
Q: 我是国内用户,搜索会自动用国内端点吗?
A: 是的。如果你已通过国内 onboarding 流程或设置了 MINIMAX_API_HOST=https://api.minimaxi.com/...,OpenClaw 会自动推断搜索也使用国内端点(api.minimaxi.com),无需单独配置。也可以在配置中显式设置 region: "cn" 来强制使用国内端点。
Q: 通过 OAuth minimax-portal 登录的用户能用 MiniMax 搜索吗?
A: 可以,但 OAuth 的 Base URL 仅用于推断区域(国内/国际),web_search 的 Provider ID 仍然是 minimax,使用 Coding Plan Key 进行认证,与模型调用的 OAuth 认证是独立的两套机制。