用途:调用 MiniMax MCP 服务器的 understand_image 工具进行图像理解与分析,适用于用户要求分析图片、描述图片内容、识别图片中物体/文字/场景,或明确使用 MiniMax 图像理解功能的场景。
主要能力:接收图片路径或 URL 以及一个针对图片的提问 prompt,返回格式化 JSON 结果。
使用方式:首次需安装依赖并配置 Key,后续可直接调用。
- 检查 uvx 是否可用:which uvx;若不存在,用官方脚本安装:curl -LsSf https://astral.sh/uv/install.sh | sh(下载失败时可先设置 UV_INDEX_URL 为清华或阿里云镜像)。
- 检查并安装 MCP 服务器:uvx minimax-coding-plan-mcp --help;未安装则执行 uvx install minimax-coding-plan-mcp(同样支持镜像加速)。
- 检查 API Key:查看 ~/.openclaw/config/minimax.json 中的 api_key,或从环境变量 MINIMAX_API_KEY 获取;缺失时向用户索要,并保存到该配置文件,其中还包含 output_path。
- 准备图片后调用脚本:python3 {curDir}/scripts/understand_image.py <图片路径或URL> "<对图片的提问>"。示例:python3 {curDir}/scripts/understand_image.py ~/image.jpg "详细描述这张图片的内容"。
参数:image(图片路径或 URL,必填,string)、prompt(对图片的提问,必填,string)。
脚本行为:优先从环境变量 MINIMAX_API_KEY 读取 Key,否则读取 ~/.openclaw/config/minimax.json;通过 stdio 模式启动 MCP 服务器并发送 JSON-RPC 请求调用 understand_image,返回格式化 JSON;错误处理包括 API Key 未配置提示、uvx 未安装提示以及输出 MCP 服务器 stderr。
限制:需要可用的 MiniMax API Key;依赖 uvx 与 minimax-coding-plan-mcp 环境。价格、速率限制与具体模型参数暂未提供。