站长自营 API 中转

正在比较模型套餐?可以把多个 AI API 接到一个网关里

ZZSwitch 是我自己运营的统一 API 网关,适合需要国内支付、兑换码充值、多模型切换和 OpenAI 兼容接口的开发者。不是 OpenCode 官方服务。

本页介绍如何将 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

  1. MiniMax Platform 创建或复制 MiniMax Coding Plan Key
  2. 设置环境变量 MINIMAX_CODE_PLAN_KEY,或通过交互式配置:
openclaw configure --section web

也支持 MINIMAX_CODING_API_KEY 作为环境变量别名;已有 Coding Plan Token 的 MINIMAX_API_KEY 作为兼容回退仍然有效。

配置

{
  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 按以下顺序自动推断:

  1. plugins.entries.minimax.config.webSearch.region
  2. MINIMAX_API_HOST
  3. models.providers.minimax.baseUrl
  4. models.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 认证是独立的两套机制。

站长自营 API 中转

ZZSwitch API 中转

统一接入多家模型,支持兑换码充值。

打开 ZZSwitch