minimax-tools

使用 MiniMax MCP 进行图像理解和网络搜索。触发条件：(1) 用户要求分析图片、理解图像 (2) 用户要求进行网络搜索、在线搜索 (3) 需要查询最新资讯、新闻、资料

整合版 MiniMax 工具集，包含图像理解 和网络搜索功能。

功能列表

功能	说明	命令
图像理解	分析图片内容、识别物体文字场景	understand_image.py
网络搜索	搜索资讯、新闻、资料	web_search.py

快速开始

首次使用（需要在目标设备上执行）

步骤 1: 安装依赖

# 检查 uvx 是否可用
which uvx

# 如果不存在，安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

步骤 2: 安装 MCP 服务器

uvx minimax-coding-plan-mcp --help

如果提示未安装，执行：

uvx install minimax-coding-plan-mcp

步骤 3: 配置 API Key

如果没有 MiniMax API Key，需要购买：https://platform.minimaxi.com/subscribe/coding-plan?code=GjuAjhGKqQ&source=link

配置 API Key：

mkdir -p ~/.openclaw/config
cat > ~/.openclaw/config/minimax.json << EOF
{
  "api_key": "你的API密钥",
  "output_path": "~/.openclaw/workspace/minimax-output"
}
EOF

或者设置环境变量：

export MINIMAX_API_KEY="你的API密钥"

---

使用方法

图像理解

# 描述图片内容
python3 ~/.openclaw/workspace/.agents/skills/minimax-tools/scripts/understand_image.py ~/image.jpg "详细描述这张图片"

# 使用 URL
python3 ~/.openclaw/workspace/.agents/skills/minimax-tools/scripts/understand_image.py "https://example.com/image.jpg" "这张图片展示了什么？"

网络搜索

# 搜索内容
python3 ~/.openclaw/workspace/.agents/skills/minimax-tools/scripts/web_search.py "今天的热点新闻"

# 搜索技术问题
python3 ~/.openclaw/workspace/.agents/skills/minimax-tools/scripts/web_search.py "Python 如何处理 JSON"

---

迁移到其他设备

需要复制到新设备的内容：

1. 脚本目录：

   ~/.openclaw/workspace/.agents/skills/minimax-tools/scripts/
   

2. 配置文件：

   • 复制 ~/.openclaw/config/minimax.json，或
   • 在新设备设置环境变量 MINIMAX_API_KEY

3. 依赖安装（在新设备上执行）：

   # 安装 uv（如需要）
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # 安装 MCP 服务器
   uvx install minimax-coding-plan-mcp
   

---

脚本说明

understand_image.py

• 优先从环境变量 MINIMAX_API_KEY 读取 API Key
• 如未设置则从 ~/.openclaw/config/minimax.json 读取
• 支持本地图片路径和 URL

web_search.py

• 优先从环境变量 MINIMAX_API_KEY 读取 API Key
• 如未设置则从 ~/.openclaw/config/minimax.json 读取
• 返回格式化的搜索结果

---

常见问题

Q: 提示 "uvx: command not found"

需要安装 uv，参见步骤 1

Q: 提示 "API Key 未配置"

需要配置 MiniMax API Key，参见步骤 3

Q: MCP 服务器连接失败

检查网络连接，或尝试重新安装：uvx install minimax-coding-plan-mcp