mcpField
M
minimax-image-understand

minimax-image-understand

github.com/cat-xierluoCreative & media76261 installsUpdated today
Repository

About minimax-image-understand

minimax-image-understand is an image-understanding skill for OpenClaw that analyzes submitted images through MiniMax MCP. It accepts an image path or URL and an optional prompt; the README says it is not intended for Claude Code.

Key features

  1. 01Understand images through MiniMax MCP
  2. 02Accept image paths or URLs
  3. 03Support an optional prompt
  4. 04Provide a Python function interface

Use cases

  1. 01Describe images submitted by users
  2. 02Identify content in an image
  3. 03Analyze an image using a prompt

MCP support

The skill uses MiniMax MCP for image understanding and calls it through the MCP Python client library. It is intended for OpenClaw.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cat-xierluo/legal-skills --skill minimax-image-understand

After installing, type/minimax-image-understandin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

CHANGELOG.md
scripts/
.env.example
image_understand.py

Details

From the project README

MiniMax MCP 图像理解

重要提示：本技能适用于 OpenClaw 平台。如果你使用的是 Claude Code，请忽略此技能。

通过 MiniMax MCP 进行图像理解。

触发条件

用户发送图片并要求分析、描述、识别时使用。

依赖

系统依赖
依赖安装方式
Python 3.10+macOS:brew install python3<br>Linux: sudo apt-get install python3
Python 包
包名用途安装命令
mcpMCP 客户端库pip install mcp

前置要求

  1. 安装依赖：pip install mcp
  2. 配置环境变量：复制 .env.example 为 .env 并填入 API Key

使用方法

cd ~/.openclaw/skills/minimax-image-understand/scripts
source .env
python3 image_understand.py <图片路径或URL> [提示词]

代码中调用

import sys
import os
sys.path.insert(0, "~/.openclaw/skills/minimax-image-understand/scripts")
os.environ["MINIMAX_API_KEY"] = "your-key"  # 或从 .env 加载
from image_understand import understand_image
result = await understand_image("image.jpg", "描述这张图片")

图片路径

图片保存位置：~/.openclaw/media/inbound/，文件名格式：{uuid}.jpg

Hermes Agent 环境说明

本 skill 在 OpenClaw 环境下可用，在 Hermes Agent 中不可用，原因：

  • MINIMAX_API_KEY 未注入到 Hermes Agent 的 shell 环境变量
  • 系统 Python 为 3.9.6，mcp 包需 Python 3.10+（可用 uv run --python 3.12 --with mcp 绕过）
  • 图像分析在 Hermes 中会失败，需改用文字描述或 OpenClaw 协助读图

配置文件

.env 文件已放在 scripts/ 目录下，格式：

MINIMAX_API_KEY=your-api-key

Comments

Markdown supported