minimax-token-plan-tool（极小极大代币计划工具）

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.

# ~/.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

# 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:

node minimax_token_plan_tool.js tools

Output format:

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

node minimax_token_plan_tool.js web_search "<query>"

Example:

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

Input Schema

{
  "query": "string"
}

Output Format

Success:

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

Error:

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

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

Examples:

Remote image:

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

Local image:

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

With @ prefix:

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

Input Schema

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

Output Format

Success:

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

Error:

{
  "error": "error message"
}

Tool 3 - minimax_token_plan_remains

Purpose

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

CLI Invocation

node minimax_token_plan_tool.js remains

Input Schema

{}

Output Format

Success:

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

Error:

{
  "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.