A robust Python-based CLI wrapper for the Mintsoft API to manage warehouses, inventory, orders, stock flow reports, and shipping notices.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install mintsoft
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install mintsoft using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Mintsoft?
The Mintsoft skill is a robust, Python-powered command-line API wrapper designed specifically to interface with the Mintsoft warehouse management and third-party logistics (3PL) platform. By leveraging this tool, developers and AI agents can seamlessly interact with the comprehensive Mintsoft REST API using a single, secure credential or automated session management. This script makes it incredibly straightforward to fetch warehouse structures, monitor outstanding orders, track inventory splits, and audit stock-flow reports directly from the terminal or an AI workflow.
As part of the broader registry of Openclaw Skills, this tool minimizes integration overhead by standardizing output formats to predictable JSON. It handles complex upstream tasks like token refresh caching, rate-limiting (429 retries), and payload summarization automatically, preventing terminal output or AI context windows from becoming oversaturated with verbose data.
Mintsoft Use Cases
- Audit and compare expected versus received quantities for Advanced Shipping Notices (ASNs) to streamline inventory intake.
- Query real-time cross-warehouse stock levels and individual inventory breakdowns per SKU to manage multi-location supply chains.
- Automatically fetch, filter, and aggregate product usage reports for outbound shipment audits and spreadsheet reconciliation.
- Monitor customer orders by status or date and inspect item-level details without manual intervention in the web dashboard.
How Mintsoft Works
- Authentication Handshake: The skill authenticates with the Mintsoft API using either a long-lived API key or cached 24-hour session credentials stored locally inside a secure JSON config.
- API Command Query: The user or AI executing Openclaw Skills issues a specific CLI command (such as
ordersorstock-levels) along with optional flags like--summaryor--since. - Request Execution & Rate Limit Handling: The Python wrapper translates the command to a REST request, interacts with the Mintsoft endpoints, and handles any potential HTTP 429 rate limit exceptions automatically.
- Data Normalization & Summarization: The raw API response undergoes data normalization (such as fixing typographical errors in ASN properties) and optional summarization before rendering.
- JSON Output: The processed and structured data is output directly to stdout in clean, standardized JSON format, facilitating easy downstream ingestion and automation.
Mintsoft Setup
To get started with this extension in your library of Openclaw Skills, ensure Python 3 is installed.
First, install the required httpx dependency:
python3 -c "import httpx" || python3 -m pip install httpx
Next, configure authentication using your API key (preferred) or your account credentials.
Option 1: Preferred API Key Configuration
export MINTSOFT_API_KEY="your-api-key-here"
python3 "scripts/mintsoft_api.py" whoami
Option 2: Session-based Auth Caching
export MINTSOFT_USERNAME="[email protected]"
export MINTSOFT_PASSWORD="yourpassword"
python3 "scripts/mintsoft_api.py" auth
# Verifies active session:
python3 "scripts/mintsoft_api.py" whoami
Mintsoft Data Schema & Taxonomy
This tool outputs structured JSON objects for downstream consumption. All list commands adhere to a standardized schema wrapper.
| Command / Resource | Output Key | Description | Primary Fields Returned |
|---|---|---|---|
warehouses |
warehouses |
Active physical and virtual locations | Warehouse ID, Name, Contact details |
orders |
orders |
Store transactions and shipment states | Order ID, Order Number, Status, Ship Date |
stock-levels |
stock_levels |
Aggregated cross-warehouse SKU levels | SKU, Quantity, Allocations, In-Stock status |
inventory |
inventory |
Granular per-warehouse stock reports | Warehouse ID, SKU, Shelf Location, Lot/Batch |
products |
products |
Comprehensive catalog and item settings | Product ID, SKU, Weight, Dimensions, Barcode |
asn-list |
asns |
Advanced Shipping Notices (inbound log) | ASN ID, Expected Date, QuantityExpected, QuantityReceived |
product-usage |
product_usage |
Historical movement reports | Date, Flow Type (IN/OUT), SKU, Qty, Details |
Mintsoft Advanced Features
- Intelligent Response Summarization: Implements the
--summaryflag by default on high-volume endpoints to prevent context saturation when using Openclaw Skills. - Robust Rate Limit Backoff: Automatically intercept, parse, and wait on HTTP 429 status codes using upstream
Retry-Afterheaders for seamless script execution during peak hours. - Secure Credential Storage: Offers persistent, local 24-hour token caching in
~/.config/mintsoft-skill/token.jsonwith file system permissions clamped to 0600. - Automatic Data Normalization: Corrects legacy upstream typos (such as
QuantityReceievednormalized toQuantityReceived) dynamically to maintain consistent interface schemas. - Flexible Date & Pagination Controls: Supports targeted API-side filtering via
--sinceand customizable--limitor--timeoutparams, ensuring long runs do not trigger unbounded context exhaustion.
SKILL.md
Loading
Related Openclaw Skills
AI Visibility & GEO Tracker
A generative engine optimization (GEO) tool that tracks if and how AI assistants like ChatGPT, Gemini, and Perplexity recommend your brand, product, or crypto token.
Crypto Trading & Sniping Agent
Equip your AI agents with real-time crypto discovery, automated rug-checking, and DEX market intelligence using pay-per-call x402 APIs.
Market & Macro Data Skill
A high-fidelity, pay-as-you-go MCP skill supplying AI agents with live macroeconomic, US Treasury, DeFi, and developer-ecosystem metrics.
Renovation Advisor
An AI-powered home renovation consultant that guides homeowners from shell to move-in, optimizing budgets, avoiding construction traps, and saving up to 20% on costs.
Content Creator Workflow
An automated multi-modal workflow that takes freelance customer requests from WhatsApp, transcribes voice notes, generates images using DALL-E 3, and sends the final assets back to the client.
OpenFate Bazi
OpenFate Bazi is an AI agent skill that enables deterministic calculations for Bazi, Four Pillars, True Solar Time, and Earthly Branch interactions through the Model Context Protocol.
Featured*
