核心用法
minimax-web-search 是一个基于 MiniMax 官方 MCP 服务器的网络搜索技能,通过 JSON-RPC 协议与 MCP 服务通信,实现对互联网实时信息的检索能力。
执行流程:
1. 环境检查:验证 uvx 包管理器及 minimax-coding-plan-mcp 服务器是否安装,缺失时提供多镜像源安装方案
2. 密钥配置:从 ~/.openclaw/config/minimax.json 读取 API Key,支持环境变量 MINIMAX_API_KEY 覆盖
3. 搜索调用:通过 web_search.py 脚本向 MCP 服务器发送 web_search 请求,返回结构化 JSON 结果
技术特点:
- 采用 stdio 模式启动 MCP 服务器,轻量无常驻进程
- 支持国内镜像加速(清华/阿里云 PyPI 源),解决网络受限环境部署问题
- 配置分层设计:环境变量 > 配置文件 > 交互式引导
显著优点
- 官方背书:MiniMax 为国产头部大模型厂商,API 稳定性与数据合规性有保障
- 实时性强:直接调用搜索引擎,获取最新资讯、新闻动态
- 部署友好:提供完整的中文安装指引与镜像加速方案,降低国内用户使用门槛
- 错误处理完善:覆盖 uvx 缺失、API Key 未配置、服务器异常等常见故障场景
潜在缺点与局限性
- 付费门槛:需购买 MiniMax Coding Plan 订阅(https://platform.minimaxi.com/subscribe),非免费服务
- 生态依赖:强耦合
uvx与 Python 环境,Windows 原生支持需额外配置 - 功能单一:仅支持基础文本搜索,无高级筛选(时间范围、站点限定、多语言)
- 输出格式固定:返回原始 JSON,需二次解析提取摘要或结构化数据
适合人群
- 需要集成实时搜索能力的 AI Agent 开发者
- 已订阅 MiniMax 服务的企业/个人用户
- 构建中文资讯类应用(新闻聚合、舆情监控)的技术团队
常规风险
- 密钥泄露风险:API Key 存储于本地明文 JSON 文件,多用户环境需严格权限控制(建议
chmod 600) - 订阅成本波动:MiniMax 平台定价策略可能调整,生产环境需预留预算评估
- 搜索结果不可控:依赖第三方搜索引擎,内容准确性、时效性、政治敏感性需人工复核
- 服务连续性:MCP 服务器版本更新可能导致协议不兼容,需关注官方变更日志