MiniMax Token Plan Tool#

Requires a Token Plan API Key Subscribe at: MInimax Token Plan (China Mainland) or MInimax Token Plan (Global)

A lightweight MiniMax Token Plan Tool skill that directly calls official APIs using pure JavaScript. No external MCP servers.

Designed for minimal overhead and fast integration within OpenClaw.

---

Features#

This skill provides three native capabilities of MiniMax Token Plan:

1. minimax_web_search#

Web search powered by MiniMax Token Plan API.

2. minimax_understand_image#

Vision-language image understanding via MiniMax VLM.

3. minimax_token_plan_remains#

Query remaining Token Plan usage and quota information.

---

Architecture#

• Pure JavaScript implementation
• Direct HTTPS API calls
• No MCP server runtime required
• No external tool dependency
• Minimal resource usage

---

Configuration#

Default recommendation: put MINIMAX_API_KEY and MINIMAX_API_HOST in ~/.openclaw/.env.

bash

# ~/.openclaw/.env
MINIMAX_API_KEY="sk-your-key"

# China Mainland
MINIMAX_API_HOST="https://api.minimaxi.com"

# or Global
MINIMAX_API_HOST="https://api.minimax.io"

OpenClaw can load these values as the default environment for this Skill. If you update ~/.openclaw/.env, restart OpenClaw or the gateway process if the new values are not picked up immediately. Only these two official hosts are supported.

Use a matching Token Plan key for the selected host:

• China Mainland tokens: platform.minimaxi.com
• Global tokens: platform.minimax.io

Optional API Host#

bash

# China Mainland
export MINIMAX_API_HOST="https://api.minimaxi.com"

# or Global
export MINIMAX_API_HOST="https://api.minimax.io"

Only https://api.minimaxi.com and https://api.minimax.io are accepted. If MINIMAX_API_HOST is not set, the script defaults to https://api.minimaxi.com.

---

Tool Discovery#

Execute minimax_token_plan_tool.js with environment variable MINIMAX_API_KEY and optional MINIMAX_API_HOST to dynamically register these tools:

text

node minimax_token_plan_tool.js tools

Output format:

text

{
  "tools": [
    {
      "name": "minimax_web_search",
      "description": "...",
      "inputSchema": { ... }
    },
    {
      "name": "minimax_understand_image",
      "description": "...",
      "inputSchema": { ... }
    },
    {
      "name": "minimax_token_plan_remains",
      "description": "...",
      "inputSchema": { ... }
    }
  ]
}

---

Tool 1 - minimax_web_search#

Purpose#

Real-time web search using MiniMax Token Plan search API.

CLI Invocation#

text

node minimax_token_plan_tool.js web_search "<query>"

Example:

text

node minimax_token_plan_tool.js web_search "OpenAI GPT-5 release date"

Input Schema#

text

{
  "query": "string"
}

Output Format#

Success:

text

{
  "success": true,
  "query": "...",
  "results": [
    {
      "title": "...",
      "link": "...",
      "snippet": "...",
      "date": "..."
    }
  ],
  "related_searches": []
}

Error:

text

{
  "error": "error message"
}

Tool 2 - minimax_understand_image#

Purpose#

Image understanding using MiniMax Token Plan VLM API. Only mainstream image formats are supported (for example: JPEG/JPG, PNG, WebP, and GIF).

Supports:

• HTTP / HTTPS image URLs
• Local file paths
• @localfile.jpg shorthand

Local files are automatically converted to base64 data URLs. Remote image URLs are fetched by this tool and then converted to data URLs before being sent to the MiniMax API. Remote image fetching is restricted to public HTTP/HTTPS targets and rejects localhost, private-network addresses, unsupported ports, and excessive redirects.

Security Notice#

This tool requires outbound network access. If a local image is provided, its content is transmitted to the remote MiniMax API for processing, which introduces a potential risk of local image data leakage. Do not submit sensitive, private, or regulated images unless you fully accept this risk.

CLI Invocation#

text

node minimax_token_plan_tool.js understand_image <image_source> "<prompt>"

Examples:

Remote image:

text

node minimax_token_plan_tool.js understand_image https://example.com/image.jpg "Describe this image"

Local image:

text

node minimax_token_plan_tool.js understand_image ./photo.png "What objects are visible?"

With @ prefix:

text

node minimax_token_plan_tool.js understand_image @photo.png "Summarize the scene"

Input Schema#

text

{
  "image_source": "string",
  "prompt": "string"
}

Output Format#

Success:

text

{
  "success": true,
  "prompt": "...",
  "image_source": "...",
  "analysis": "model response"
}

Error:

text

{
  "error": "error message"
}

Tool 3 - minimax_token_plan_remains#

Purpose#

Query remaining Token Plan usage through the MiniMax open platform remains endpoint.

CLI Invocation#

text

node minimax_token_plan_tool.js remains

Input Schema#

text

{}

Output Format#

Success:

text

{
  "success": true,
  "remains": {
    "...": "provider response"
  }
}

Error:

text

{
  "error": "error message"
}

Note:

• All times are in UTC+0. Convert them based on the user's local region.
• For all models, MiniMax-M* uses a 5-hour period. Other generative models use a 1-day period.
• remains_time and weekly_remains_time are formatted as DD:HH:MM:SS.
• *_quota = 0 means the current Token Plan subscription does not include that model.

---

Official Recommendation#

This Skill is a lightweight JavaScript implementation built on top of the official MiniMax APIs. For best compatibility and long-term support, the official MCP is recommended: MiniMax-Coding-Plan-MCP.

For speech synthesis, image generation, and video generation, the official Skill is recommended: Minimax-Multimodal-Toolkit.