← Back to Skills Marketplace
matthew77

Minimax API

by Liang · GitHub ↗ · v1.0.3 · MIT-0
cross-platform ⚠ suspicious
237
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install minimax-api
Description
Provides image analysis and description from URLs or local files plus real-time web search using MiniMax's Token Plan API.
Usage Guidance
Key points to consider before installing: - Credential declaration mismatch: The skill actually requires a MiniMax API key (scripts use --api-key and SKILL.md references MINIMAX_API_KEY), but the registry metadata lists no required env var/primary credential. Ask the publisher to fix metadata or code so it's clear how the agent supplies the key. Do not assume the platform will inject a secret unless the skill metadata declares it. - Usage mismatch: The SKILL.md examples show exporting MINIMAX_API_KEY and running the script without --api-key, but the Python scripts require --api-key. This will cause runtime errors or confusion when integrated; request a corrected SKILL.md or code that reads the env var when present. - Data exfiltration/privacy: For local files, the script reads the file and encodes it as a data URL (base64) and sends it to https://api.minimaxi.com. That is necessary for remote image analysis but is effectively uploading the entire file to a third party. Avoid providing sensitive images or grant the skill access only to non-sensitive paths. - Source provenance: The skill has unknown source/homepage. Prefer skills with a verifiable maintainer, repository, or homepage. Verify the domain api.minimaxi.com is legitimate for the service you expect. - Secret handling: Do not pass API keys on the command line if others can view shell history/process list; prefer secure secret storage offered by the platform (and confirm how the agent will supply the key). If you must export to a shell, be aware of shell history and ~/.bashrc persistence implications. - Operational fix suggestions: Require the publisher to (1) declare MINIMAX_API_KEY in registry metadata as a required/primary credential, (2) either accept the env var in the scripts (fallback from MINIMAX_API_KEY) or update SKILL.md to require passing --api-key, and (3) provide a verified homepage or source repository. Given these inconsistencies (missing declared credential and conflicting usage instructions) and the privacy implications of uploading local files, treat this skill cautiously until the publisher corrects metadata and usage guidance.
Capability Analysis
Type: OpenClaw Skill Name: minimax-api Version: 1.0.3 The skill provides image analysis and web search capabilities via the MiniMax API. The script `scripts/minimax_image.py` allows the agent to read arbitrary local files and transmit their base64-encoded content to an external endpoint (api.minimaxi.com). While this behavior is documented for the purpose of analyzing local images, the lack of file-type validation or path restrictions poses a risk of data exfiltration if the agent is manipulated into reading sensitive system files (e.g., SSH keys or configuration files) instead of images.
Capability Assessment
Purpose & Capability
The name/description match the included scripts: minimax_image.py implements VLM image calls and minimax_search.py implements search calls to https://api.minimaxi.com. No unrelated services, binaries, or credentials are requested by the capability itself.
Instruction Scope
SKILL.md instructs sending HTTP/HTTPS images or local files; the scripts indeed read local files and convert them to base64 for upload to the external API (this is expected for image analysis). However SKILL.md shows usage that omits the required CLI --api-key argument (it suggests exporting MINIMAX_API_KEY and running the script without --api-key), while the scripts' argparse require --api-key. This mismatch is an operational/instructional incoherence. Also note: local image files are read and their full contents are transmitted to the remote API (privacy/exfiltration risk inherent to the feature).
Install Mechanism
There is no install spec (instruction-only plus included scripts). No downloads or archive extraction are requested. The scripts are simple Python clients using urllib; network access to api.minimaxi.com is required, which is consistent with the stated functionality.
Credentials
Registry metadata lists no required environment variables or primary credential, but SKILL.md and both scripts clearly require a MiniMax API key (SKILL.md suggests MINIMAX_API_KEY; scripts require --api-key). This is an inconsistency: the skill should declare MINIMAX_API_KEY (or otherwise explain how the key is provided). Additionally, the skill will upload base64-encoded local files to a third-party endpoint, so the credential grants network access tied to potentially sensitive data — that should be explicitly declared and limited.
Persistence & Privilege
The skill does not request always:true and does not appear to modify other skills or system settings. It runs as invoked and performs network calls; normal autonomous invocation is allowed by platform defaults (no additional privilege observed).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install minimax-api
  3. After installation, invoke the skill by name or use /minimax-api
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
Revert scripts to original; users follow SKILL.md setup instructions
v1.0.2
Restore original scripts; SKILL.md has setup instructions for users
v1.0.1
Use MINIMAX_API_KEY env var; add setup instructions to SKILL.md
v1.0.0
Initial publish
Metadata
Slug minimax-api
Version 1.0.3
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is Minimax API?

Provides image analysis and description from URLs or local files plus real-time web search using MiniMax's Token Plan API. It is an AI Agent Skill for Claude Code / OpenClaw, with 237 downloads so far.

How do I install Minimax API?

Run "/install minimax-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Minimax API free?

Yes, Minimax API is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Minimax API support?

Minimax API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Minimax API?

It is built and maintained by Liang (@matthew77); the current version is v1.0.3.

💬 Comments