โ Back to Skills Marketplace
AB Agents Vision (MiniMax)
by
alexburrstudio
ยท GitHub โ
ยท v1.0.3
ยท MIT-0
68
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install ab-agents-vision-minimax
Description
๐๏ธ Image analysis via MiniMax VL API. Describe images, extract text from screenshots, analyze photos. Requires MiniMax Token Plan API key (free tier availab...
README (SKILL.md)
AB Agents Vision (MiniMax) ๐๏ธ
Image analysis via MiniMax VL API โ simple, fast, reliable.
โ ๏ธ Requires MiniMax Token Plan API key โ get free key
What It Does
- ๐ธ Describe images โ Get detailed scene descriptions
- ๐ Extract text โ Read from screenshots, photos, documents
- ๐ Analyze photos โ Identify objects, people, settings
- ๐ URL support โ Analyze images from the web
Requirements
- MiniMax Token Plan API key โ Subscribe free
- Linux/macOS
uvx(auto-installed)
Quick Start
# 1. Install uvx
curl -LsSf https://astral.sh/uv/install.sh | sh
# 2. Get free MiniMax API key
# https://platform.minimax.io โ Subscribe โ Token Plan (free tier)
# 3. Use
export MINIMAX_API_KEY="sk-cp-your-key"
./vision.sh image.jpg "Describe this image"
Usage
# Basic description
./vision.sh photo.jpg
# With custom prompt
./vision.sh screenshot.png "What text do you see?"
# URL support
./vision.sh "https://example.com/image.jpg" "Describe this"
Examples
Screenshot analysis:
Input: screenshot.png + "What text is in the image?"
Output: "The screenshot shows a code editor with Python code..."
Photo description:
Input: photo.jpg + "Describe in detail"
Output: "A person's bare foot and lower leg resting on a brown
textured waffle-weave blanket. The skin is light-toned..."
Installation
git clone https://github.com/alexburrstudio/ab-agents-vision.git
cd ab-agents-vision/skills/vision
chmod +x vision.sh
Or via ClaWHub:
clawhub install AB-Agents-Vision-MiniMax
Troubleshooting
| Error | Solution |
|---|---|
| API Error: 1033 | Retry โ MiniMax system error |
| No response | Check MINIMAX_API_KEY is set correctly |
| Slow | Use smaller images (\x3C10MB) |
AB-Agents ๐ฆ
Related Skills
๐ AB Agents Meter Reader โ Read meter readings from photos (uses this skill for vision)
AB-Agents ๐ฆ
Usage Guidance
Before installing or running this skill: 1) Expect to provide a MINIMAX_API_KEY โ the registry metadata omitted this but both SKILL.md and the script require it. 2) Inspect vision.sh yourself (it's included) and decide whether you are comfortable with its fallback that reads /root/.openclaw/.minimax-env; if you don't want that, remove or edit that line so the script only uses the explicit environment variable. 3) Avoid blindly running the recommended curl | sh installer for uvx; instead obtain uvx from a vetted source or review the installer script before executing. 4) Run the skill in a restricted/sandboxed environment if you are unsure, and ensure the MINIMAX_API_KEY you supply is scoped only to the MiniMax service (don't reuse broad or privileged tokens). 5) Prefer that the skill metadata be updated to declare MINIMAX_API_KEY and any other required binaries so the requirements match the actual behavior.
Capability Analysis
Type: OpenClaw Skill
Name: ab-agents-vision-minimax
Version: 1.0.3
The skill contains a significant vulnerability in `vision.sh` where user-provided arguments ($PROMPT and $IMAGE_PATH) are unsafely interpolated into a JSON-RPC string, enabling potential JSON injection attacks against the underlying MCP tool. Furthermore, the script hardcodes paths to the root directory (`/root/.openclaw/.minimax-env`) to retrieve API keys, which is a high-privilege assumption and a poor security practice for handling sensitive credentials. While these appear to be functional flaws rather than intentional malice, they represent meaningful high-risk behaviors.
Capability Tags
Capability Assessment
Purpose & Capability
The skill's stated purpose (image analysis via MiniMax) matches the code's behavior (it calls a MiniMax plan via uvx). However the registry metadata declares no required environment variables while SKILL.md and the script require MINIMAX_API_KEY and the uvx binary. That mismatch between declared requirements and actual requirements is an incoherence to be aware of.
Instruction Scope
SKILL.md instructs installation of uvx and setting MINIMAX_API_KEY. The shipped script (vision.sh) reads MINIMAX_API_KEY from the environment but also silently falls back to reading /root/.openclaw/.minimax-env if the env var is not set. That fallback means the skill will try to read an absolute system path (potentially containing other secrets) without declaring it, which expands its data access beyond the described usage.
Install Mechanism
There is no formal install spec in the registry (instruction-only), but SKILL.md recommends installing uvx via a curl | sh from https://astral.sh. Piping remote install scripts to sh is higher risk than using a vetted package manager or an audited release; the install source is not a canonical OS package host and is worth manual review.
Credentials
Requesting a MiniMax API key is appropriate for this purpose. But the registry failing to declare MINIMAX_API_KEY (and the script's secret-file fallback) are disproportionate and unclear. The script's attempt to read /root/.openclaw/.minimax-env could expose other tokens stored there. The skill does not request unrelated cloud credentials, but its undeclared file access is problematic.
Persistence & Privilege
The skill does not request always: true and does not attempt to modify other skills or system-wide settings. Still, the script's reading of an absolute path (/root/.openclaw/.minimax-env) is a form of data access privilege that should be considered before installing or running.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ab-agents-vision-minimax - After installation, invoke the skill by name or use
/ab-agents-vision-minimax - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Added a "Related Skills" section linking to AB Agents Meter Reader.
- No changes to functionality or usage.
v1.0.2
- Updated project homepage URL in SKILL.md to point to the new repository location.
- Revised git installation instructions in SKILL.md to use the new repository URL.
v1.0.1
- Improved documentation with detailed usage instructions, quick start guide, and troubleshooting tips.
- Clarified feature list: image description, text extraction, photo analysis, and URL support.
- Added API requirements and installation instructions.
- Provided practical examples for common use cases.
- Updated error handling and support guidance.
Metadata
Frequently Asked Questions
What is AB Agents Vision (MiniMax)?
๐๏ธ Image analysis via MiniMax VL API. Describe images, extract text from screenshots, analyze photos. Requires MiniMax Token Plan API key (free tier availab... It is an AI Agent Skill for Claude Code / OpenClaw, with 68 downloads so far.
How do I install AB Agents Vision (MiniMax)?
Run "/install ab-agents-vision-minimax" in the OpenClaw or Claude Code chat to install it in one step โ no extra setup required.
Is AB Agents Vision (MiniMax) free?
Yes, AB Agents Vision (MiniMax) is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does AB Agents Vision (MiniMax) support?
AB Agents Vision (MiniMax) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created AB Agents Vision (MiniMax)?
It is built and maintained by alexburrstudio (@alexburrstudio); the current version is v1.0.3.
More Skills