核心用法
MiniMax Token Plan Tool 是一款纯 JavaScript 实现的轻量级工具，直接调用 MiniMax 官方 API，无需外部 MCP 服务器或子进程桥接。通过环境变量 MINIMAX_API_KEY 和可选的 MINIMAX_API_HOST 配置，即可在 OpenClaw 环境中快速集成。
该 skill 提供三大核心能力：
1. minimax_web_search：实时网络搜索，支持标准查询返回结构化结果（标题、链接、摘要、日期及相关搜索）
2. minimax_understand_image：基于 MiniMax VLM 的视觉语言理解，支持 HTTP/HTTPS 图片 URL、本地文件路径及 @ 快捷语法，自动处理 base64 编码
3. minimax_token_plan_remains：查询 Token Plan 剩余配额和使用情况，返回包含周期配额、重置时间等详细数据
显著优点
- 零依赖架构：纯 JavaScript 实现，无外部 MCP 服务器、无工具桥接、无子进程调用，资源占用极低
- 快速集成：仅需 Node.js 环境和 API 密钥即可运行，支持
~/.openclaw/.env自动加载配置 - 灵活的图像处理：本地图片自动转 base64，远程图片自动抓取，支持多种主流格式（JPEG、PNG、WebP、GIF）
- 双区域支持：兼容中国大陆（api.minimaxi.com）和全球（api.minimax.io）两个端点
- CLI 友好：提供清晰的命令行调用方式，支持动态工具发现和 JSON 格式输出
潜在缺点与局限性
- 功能范围有限：仅覆盖 Token Plan 的三项基础能力，不包含语音合成、图像生成、视频生成等多模态功能（需使用官方推荐的 Minimax-Multimodal-Toolkit）
- 网络依赖：所有功能均需联网，图像理解功能会将本地图片内容上传至远程 API，存在数据泄露风险
- 无官方 MCP 兼容性：虽设计为轻量替代方案，但官方仍推荐使用 MiniMax-Coding-Plan-MCP 以获得长期支持
- 密钥管理风险：API 密钥通过环境变量或配置文件传递，需用户自行确保存储安全
- 配额复杂性：Token Plan 的配额机制较复杂（5 小时/1 天/周级重置），需仔细阅读文档理解
usage_count实际表示"剩余配额"而非"已使用量"
适合人群
- 追求极简部署、快速验证 MiniMax Token Plan 能力的开发者
- 资源受限环境（如边缘设备、容器）中需要轻量级 AI 工具集成的用户
- 熟悉 Node.js 和命令行操作的技术用户
- 需要快速原型开发，暂不追求完整 MCP 生态兼容性的场景
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据隐私 | 图像理解功能上传本地图片至远程服务器，敏感图片可能泄露 |
| 密钥泄露 | API 密钥存储于本地配置文件或环境变量，需防范未授权访问 |
| 网络中断 | 纯云端依赖，离线环境完全不可用 |
| 配额误读 | `usage_count` 字段语义特殊（表示剩余而非已用），易误解为额度耗尽 |
| 区域混淆 | 中国大陆与全球密钥/端点不可混用，配置错误导致认证失败 |