MiniMax Search via Token Plan API Integration

This page explains how to configure MiniMax as a web_search provider using the Token Plan search API. It covers credential creation, key storage, and environment variable setup for OpenClaw users.

Read this when

  • You want to use MiniMax for web_search
  • You need a MiniMax Token Plan key or OAuth token
  • You want MiniMax CN/global search host guidance

OpenClaw integrates MiniMax as a web_search provider using the MiniMax Token Plan search API. The API delivers organized search results containing titles, URLs, snippets, and related queries.

Get a Token Plan credential

Create a key

Generate or duplicate a MiniMax Token Plan key from the MiniMax Platform. For OAuth configurations, MINIMAX_OAUTH_TOKEN can be used instead.

Store the key

Define MINIMAX_CODE_PLAN_KEY in the Gateway environment, or set it up using:

openclaw configure --section web

Additionally, OpenClaw recognizes MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN, and MINIMAX_API_KEY as environment variable alternatives, evaluated in that sequence following MINIMAX_CODE_PLAN_KEY. MINIMAX_API_KEY must point to a Token Plan credential with search enabled; standard MiniMax model API keys may not work with 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",
      },
    },
  },
}

Alternative via environment: assign MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN, or MINIMAX_API_KEY within the Gateway environment. For a gateway deployment, place it in ~/.openclaw/.env.

Region selection

MiniMax Search utilizes these endpoints:

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

When plugins.entries.minimax.config.webSearch.region is not configured, OpenClaw determines the region by checking in this order:

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

Consequently, CN onboarding or MINIMAX_API_HOST=https://api.minimaxi.com/... will also direct MiniMax Search to the CN host automatically.

Even if you authenticated MiniMax through the OAuth minimax-portal flow, web search still uses provider id minimax; the OAuth provider base URL serves as a region hint for choosing between CN and global hosts, and MINIMAX_OAUTH_TOKEN can fulfill the MiniMax Search bearer credential requirement.

Supported parameters

ParameterTypeConstraintsDescription
querystringrequiredThe text to search for.
countinteger1-10, default 5Desired number of results. OpenClaw reduces the returned list to this count.

Provider-specific filters are not available at this time.

  • Web Search overview -- covers all providers and auto-detection
  • MiniMax -- model, image, speech, and authentication configuration
372 words · updated Jul 27, 2026