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:
- Plugin-owned
webSearch.region MINIMAX_API_HOSTmodels.providers.minimax.baseUrlmodels.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
| Parameter | Type | Constraints | Description |
|---|---|---|---|
query | string | required | The text to search for. |
count | integer | 1-10, default 5 | Desired number of results. OpenClaw reduces the returned list to this count. |
Provider-specific filters are not available at this time.
Related
- Web Search overview -- covers all providers and auto-detection
- MiniMax -- model, image, speech, and authentication configuration