MiniMax search

기준일: 2026-07-26
난이도: 중급
공식 기준: MiniMax search

개요

이 페이지는 OpenClaw MiniMax search 도구(파라미터, 권한, 설정, CLI)를 공식 문서 기준으로 정리합니다.

공식 요약: MiniMax Search via the Token Plan search API

도구 가시성은 profile / allow·deny policy / sandbox / channel 권한에 따라 달라집니다. 최신 스키마는 항상 공식 문서를 우선합니다.

공식 문서 기반 상세

아래는 공식 tools/minimax-search 문서를 정리한 내용입니다. 코드 블록, 파라미터 이름, 기본값은 원문 그대로입니다.

OpenClaw supports MiniMax as a web_search provider through the MiniMax Token Plan search API. It returns structured search results with titles, URLs, snippets, and related queries.

Get a Token Plan credential

Create a key

Create or copy a MiniMax Token Plan key from
[MiniMax Platform](https://platform.minimax.io/user-center/basic-information/interface-key).
OAuth setups can reuse `MINIMAX_OAUTH_TOKEN` instead.

Store the key

Set `MINIMAX_CODE_PLAN_KEY` in the Gateway environment, or configure via:

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

OpenClaw also accepts MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN, and MINIMAX_API_KEY as env aliases, checked in that order after MINIMAX_CODE_PLAN_KEY. MINIMAX_API_KEY should point at a search-enabled Token Plan credential; ordinary MiniMax model API keys may not be accepted by the Token Plan search endpoint.

Config

{
  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",
      },
    },
  },
}

Environment alternative: set MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN, or MINIMAX_API_KEY in the Gateway environment. For a gateway install, put it in ~/.openclaw/.env.

Region selection

MiniMax Search uses these endpoints:

• Global: https://api.minimax.io/v1/coding_plan/search
• CN: https://api.minimaxi.com/v1/coding_plan/search

If plugins.entries.minimax.config.webSearch.region is unset, OpenClaw resolves the region in this order:

1. Plugin-owned webSearch.region
2. MINIMAX_API_HOST
3. models.providers.minimax.baseUrl
4. models.providers.minimax-portal.baseUrl

That means CN onboarding or MINIMAX_API_HOST=https://api.minimaxi.com/... automatically keeps MiniMax Search on the CN host too.

Even when you authenticated MiniMax through the OAuth minimax-portal path, web search still registers as provider id minimax; the OAuth provider base URL is used as a region hint for CN/global host selection, and MINIMAX_OAUTH_TOKEN can satisfy the MiniMax Search bearer credential.

Supported parameters

Parameter	Type	Constraints	Description
query	string	required	Search query string.
count	integer	1-10, default 5	Number of results to return. OpenClaw trims the returned list to this size.

Provider-specific filters are not currently supported.

관련 문서

• Web Search overview -- all providers and auto-detection
• MiniMax -- model, image, speech, and auth setup

검증 체크리스트

• 해당 tool이 활성 profile/policy에서 허용되는지 확인
• sandbox / elevated / host 실행 경로 정책을 이해했는지 확인
• 채널·에이전트 권한과 충돌하지 않는지 확인
• 공식 CLI/--help와 문서 옵션이 버전과 맞는지 확인

관련

• Tools 목록 인덱스
• 공식: Tools overview, Tools and custom providers