- name
- minimax-understand-image
- description
- 使用 MiniMax MCP 进行图像理解和分析。触发条件：(1) 用户要求分析图片、理解图像、描述图片内容 (2) 需要识别图片中的物体、文字、场景 (3) 使用 MiniMax 的 understand_image 功能
minimax-understand-image
使用 MiniMax MCP 服务器进行图像理解和分析。
执行流程（首次需要安装，后续直接步骤4调用）
步骤 1: 检查并安装依赖
1.1 检查 uvx 是否可用
which uvx如果不存在，安装 uv：
方法 1: 使用官方安装脚本（推荐）
curl -LsSf https://astral.sh/uv/install.sh | sh方法 2: 使用国内镜像加速（如果官方脚本下载失败）
临时使用清华镜像源安装：
export UV_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"
curl -LsSf https://astral.sh/uv/install.sh | sh或者临时使用阿里云镜像源：
export UV_INDEX_URL="https://mirrors.aliyun.com/pypi/simple/"
curl -LsSf https://astral.sh/uv/install.sh | sh1.2 检查 MCP 服务器是否已安装
uvx minimax-coding-plan-mcp --help执行命令判断是否MCP服务器已安装， 如果安装了跳到步骤 2。
1.3 安装 MCP 服务器（如果未安装）
方法 1: 使用默认源安装
uvx install minimax-coding-plan-mcp方法 2: 使用国内镜像加速（如果默认源下载失败）
临时使用清华镜像源：
export UV_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"
uvx install minimax-coding-plan-mcp或者临时使用阿里云镜像源：
export UV_INDEX_URL="https://mirrors.aliyun.com/pypi/simple/"
uvx install minimax-coding-plan-mcp步骤 2: 检查 API Key 配置
cat ~/.openclaw/config/minimax.json 2>/dev/null | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('api_key', ''))"如果返回非空的 API Key，跳到步骤 4。
步骤 3: 配置 API Key（如果未配置）
3.1 尝试从 ~/.openclaw/agents/main/agent/auth-profiles.json 中的配置文件中获取
根据返回的判断：
- 名称包含 "minimax" 或 "MiniMax"
找到匹配的 Key 后，询问用户确认是否使用。
3.2 如果没有找到 Key，向用户索要
直接询问用户提供 MiniMax API Key。 如果未购买MiniMax，购买地址为: https://platform.minimaxi.com/subscribe/coding-plan?code=GjuAjhGKqQ&source=link
3.3 保存 API Key
mkdir -p ~/.openclaw/config
cat > ~/.openclaw/config/minimax.json << EOF
{
"api_key": "API密钥",
"output_path": "~/.openclaw/workspace/minimax-output"
}
EOF步骤 4: 使用 MCP 处理图像
4.1 准备图片
将图片放到可访问路径，例如：
~/.openclaw/workspace/images/图片名.jpg- 或者使用 URL
4.2 调用 understand_image
使用脚本调用 MCP 服务：
python3 {curDir}/scripts/understand_image.py <图片路径或URL> "<对图片的提问>"示例：
# 描述图片内容
python3 {curDir}/scripts/understand_image.py ~/image.jpg "详细描述这张图片的内容"
# 使用 URL
python3 {curDir}/scripts/understand_image.py "https://example.com/image.jpg "这张图片展示了什么？"4.3 API 参数说明
| 参数 | 说明 | 类型 |
|---|---|---|
| image | 图片路径或 URL | string (必填) |
| prompt | 对图片的提问 | string (必填) |
脚本说明
脚本位置：{curDir}/scripts/understand_image.py
功能：
- 优先从环境变量
MINIMAX_API_KEY读取 API Key，如果没有则从~/.openclaw/config/minimax.json读取 - 通过 stdio 模式启动 MCP 服务器
- 发送 JSON-RPC 请求调用
understand_image工具 - 返回格式化的 JSON 结果
错误处理：
- API Key 未配置时提示错误
- uvx 未安装时提示安装命令
- MCP 服务器错误时显示 stderr 输出