核心用法
minimax-web-search 是一款基于 MiniMax MCP（Model Context Protocol）的实时网络搜索工具，专为需要获取最新互联网信息的 AI 工作流设计。其核心功能是通过调用 MiniMax 的 web_search 工具，返回结构化的搜索结果。
典型触发场景
- 用户明确要求进行网络搜索、在线查找、获取最新资讯
- 需要查询实时新闻、热点事件、动态数据等时效性内容
- 主动调用 MiniMax 的 web_search 功能
使用流程
1. 环境准备：自动检测并安装 uvx 和 MiniMax MCP 服务器，支持国内镜像加速
2. 密钥配置：从 ~/.openclaw/config/minimaxi.json 读取 API Key，或引导用户购买并配置
3. 执行搜索：调用封装脚本 web_search.py 发送 JSON-RPC 请求，返回格式化结果
技术特点
- 支持环境变量与配置文件双模式读取 API Key
- 采用 stdio 模式启动 MCP 服务器，轻量稳定
- 内置多层错误处理：uvx 缺失、密钥未配置、服务器异常等
显著优点
- ✅ 开箱即用：自动处理依赖安装与配置，降低使用门槛
- ✅ 国内友好：内置清华/阿里云镜像源，解决网络访问问题
- ✅ 结构化输出：返回 JSON 格式结果，便于后续处理
- ✅ 时效性强：直接对接 MiniMax 搜索能力，信息新鲜度高
潜在缺点与局限
- ⚠️ 商业付费：需购买 MiniMax API Key（约 50-200/月），非免费服务
- ⚠️ 生态依赖：绑定 MiniMax 平台，无法切换其他搜索源
- ⚠️ 结果质量受制：搜索质量取决于 MiniMax 的网页索引覆盖与排序算法
- ⚠️ 无本地缓存：每次调用实时请求，无离线能力
- ⚠️ 配置门槛：涉及 uvx、MCP、JSON-RPC 等技术栈，非技术用户理解成本较高
适合人群
- 🔹 需要实时信息的 AI Agent 开发者（如新闻摘要、热点追踪）
- 🔹 使用 Claude/Cursor 等支持 MCP 的 IDE/工具的技术用户
- 🔹 已购买 MiniMax API 或愿意付费获取稳定搜索能力的团队
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| **密钥泄露** | API Key 存储于本地明文文件 | 设置文件权限 `chmod 600`，优先使用环境变量 |
| **费用失控** | 高频调用可能导致超额消费 | 设置用量告警，监控平台账单 |
| **结果不可控** | 搜索结果可能包含不实信息 | 建议结合多源交叉验证 |
| **服务中断** | 依赖 MiniMax 平台稳定性 | 设计降级策略（如备用搜索源）|
| **依赖维护** | uvx/MCP 版本更新可能破坏兼容性 | 锁定版本，定期回归测试 |