核心用法
minimax-web-search 是一款基于 MiniMax MCP（Model Context Protocol）服务器的网络搜索技能，专为需要实时获取互联网信息的场景设计。用户通过自然语言触发搜索指令后，系统会自动完成环境检查、依赖安装、API 配置和搜索调用的一整套流程。
执行流程概览：
1. 环境检查：自动检测 uvx 包管理器及 minimax-coding-plan-mcp 服务器的安装状态
2. 依赖安装：若缺失，支持官方源或国内镜像（清华/阿里云）加速安装
3. API 配置：从本地配置文件读取或引导用户输入 MiniMax API Key（格式 sk-cp- 开头）
4. 搜索执行：通过 Python 脚本以 stdio 模式调用 MCP 服务器的 web_search 工具，返回结构化 JSON 结果
触发条件：用户明确要求网络搜索、在线查询、查找最新资讯/新闻/资料，或指定使用 MiniMax 的 web_search 功能。
显著优点
- 即装即用：首次使用时自动完成全链路环境配置，无需手动干预
- 智能容错：内置多镜像源 fallback 机制，解决国内网络访问问题
- 配置复用：支持从
~/.openclaw/agents/main/agent等现有配置中提取 API Key，减少重复输入 - 标准化输出：基于 MCP 协议，返回格式统一的 JSON 数据，便于下游处理
- 安全存储：API Key 本地持久化存储于
~/.openclaw/config/minimax.json，支持环境变量覆盖
潜在缺点与局限性
- 商业依赖：必须持有有效的 MiniMax Coding Plan 订阅（购买入口：https://platform.minimaxi.com/subscribe/coding-plan），免费额度或可用性受厂商政策约束
- 地域限制：国内镜像加速虽缓解下载问题，但 API 服务本身受 MiniMax 平台区域可用性影响
- 单供应商风险：搜索能力完全绑定 MiniMax 生态，无多源聚合或 failover 机制
- 配置复杂度：涉及 uvx、MCP 服务器、API Key 三级配置，对新手用户仍存在认知门槛
- 脚本依赖：搜索执行依赖本地 Python 脚本
{curDir}/scripts/web_search.py，路径硬编码可能引发跨平台问题
适合人群
- 已订阅 MiniMax Coding Plan 的开发者与内容创作者
- 需要集成实时搜索能力的 AI Agent 构建者
- 对国内大模型生态有偏好，希望统一使用 MiniMax 服务栈的用户
- 能接受初期环境配置投入，追求后续自动化体验的技术用户
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| API Key 泄露 | 本地明文存储配置文件，存在被其他进程读取风险 | 建议设置文件权限 600，定期轮换 Key |
| 供应链攻击 | uvx 安装脚本及 PyPI 包存在被篡改可能 | 校验官方脚本签名，使用可信镜像源 |
| 隐私合规 | 搜索查询内容会上传至 MiniMax 服务器处理 | 避免搜索敏感个人信息，查阅厂商隐私政策 |
| 服务中断 | 单一供应商依赖，API 限流或故障时无备用方案 | 关键业务场景建议设计降级策略 |
| 计费失控 | 高频搜索可能快速消耗订阅额度 | 设置用量监控与告警阈值 |