核心用法
MiniMax MCP Skill 是一个集成 MiniMax Coding Plan API 的实用工具,提供两大核心能力:网络搜索与图片理解。
网络搜索:通过调用 https://api.minimaxi.com/v1/coding_plan/search 端点,获取实时信息、新闻动态和各类研究资料。支持 JSON 格式返回,包含标题、链接、摘要等结构化数据。
图片理解:利用 VLM(视觉语言模型)能力分析图片内容,支持本地图片 Base64 编码上传或网络图片处理。端点为 https://api.minimaxi.com/v1/coding_plan/vlm,可执行图片描述、信息提取等任务。支持 JPEG、PNG、GIF、WebP 格式,单文件最大 20MB。
配置方式采用本地环境文件管理,用户需在 ~/.openclaw/config/minimax-api.env 中配置 MINIMAX_API_KEY,通过 source 命令加载后使用 curl 发起请求。
显著优点
1. 实时信息获取:突破大模型知识截止时间限制,可搜索当日新闻和最新动态
2. 多模态能力:集成文本搜索与视觉理解,满足图文混合场景需求
3. 标准化接口:基于 HTTP/curl 的调用方式,兼容性强,易于集成到各类工作流
4. 输出可定制:返回结构化 JSON,支持 Python 等工具二次加工美化输出
5. 权限管控严谨:API Key 由用户本地保管,工具本身不持有敏感凭证
潜在缺点与局限性
1. 依赖外部服务:MiniMax API 的可用性、响应速度和定价策略直接影响使用体验
2. 需人工配置:首次使用必须完成 API Key 申请和本地配置,存在门槛
3. 国内服务限制:MiniMax 平台注册和 API 调用可能存在地域或实名认证要求
4. 频率限制未明确:文档提及存在搜索频率限制,但具体阈值未披露
5. 错误处理简陋:示例中缺乏对 API 错误码、超时、限流的处理逻辑
适合人群
- 需要追踪实时资讯的研究者、分析师、内容创作者
- 希望为 AI 助手扩展联网能力的开发者和技术用户
- 有图片内容自动化分析需求的设计师、运营人员
- 已具备 MiniMax 平台账号和 API Key 的现有用户
常规风险
- API Key 泄露风险:本地配置文件若权限设置不当(未执行
chmod 600)可能被其他用户读取;命令历史中可能残留含 Key 的命令 - 网络请求暴露:curl 命令在调用时 API Key 以明文形式存在于请求头中,存在被网络监控或日志记录的风险
- 数据隐私:搜索关键词和图片内容会上传至 MiniMax 服务器,敏感信息可能面临第三方处理
- 服务可用性:依赖单一厂商 API,存在服务中断、策略变更或价格调整风险
- 内容合规:搜索返回内容和图片分析结果未经本地过滤,需用户自行判断合规性