技能名称: minimax-understand-image

详细描述:

minimax-understand-image

使用 MiniMax MCP 服务器进行图像理解和分析。

执行流程（首次需要安装，后续直接步骤4调用）

步骤 1: 检查并安装依赖

1.1 检查 uvx 是否可用

bash
which uvx

如果不存在，安装 uv：

方法 1: 使用官方安装脚本（推荐）
bash
curl -LsSf https://astral.sh/uv/install.sh | sh

方法 2: 使用国内镜像加速（如果官方脚本下载失败）

临时使用清华镜像源安装：
bash
export UVINDEXURL=https://pypi.tuna.tsinghua.edu.cn/simple
curl -LsSf https://astral.sh/uv/install.sh | sh

或者临时使用阿里云镜像源：
bash
export UVINDEXURL=https://mirrors.aliyun.com/pypi/simple/
curl -LsSf https://astral.sh/uv/install.sh | sh

1.2 检查 MCP 服务器是否已安装

bash
uvx minimax-coding-plan-mcp --help

执行命令判断是否MCP服务器已安装， 如果安装了跳到步骤 2。

1.3 安装 MCP 服务器（如果未安装）

方法 1: 使用默认源安装
bash
uvx install minimax-coding-plan-mcp

方法 2: 使用国内镜像加速（如果默认源下载失败）

临时使用清华镜像源：
bash
export UVINDEXURL=https://pypi.tuna.tsinghua.edu.cn/simple
uvx install minimax-coding-plan-mcp

或者临时使用阿里云镜像源：
bash
export UVINDEXURL=https://mirrors.aliyun.com/pypi/simple/
uvx install minimax-coding-plan-mcp

步骤 2: 检查 API Key 配置

bash
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

bash
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 服务：

bash
python3 {curDir}/scripts/understand_image.py <图片路径或URL> <对图片的提问>

示例：

bash

描述图片内容

使用 URL

4.3 API 参数说明

脚本说明

脚本位置：{curDir}/scripts/understand_image.py

功能：

• - 优先从环境变量 MINIMAXAPIKEY 读取 API Key，如果没有则从 ~/.openclaw/config/minimax.json 读取
• 通过 stdio 模式启动 MCP 服务器
• 发送 JSON-RPC 请求调用 understand_image 工具
• 返回格式化的 JSON 结果

错误处理：

• - API Key 未配置时提示错误
• uvx 未安装时提示安装命令
• MCP 服务器错误时显示 stderr 输出