modbender SKILL.md - MiniMax Usage Tracker
Skill Information
- Skill Name: openclaw-skill-minimax-tracker
- Version: 1.0.0
- Author: QiaoTuCodes (Weiran), Yanyan
- Description: Track and monitor MiniMax API usage with progress bars and reminders for OpenClaw
- Repository: https://github.com/QiaoTuCodes/openclaw-skill-minimax-tracker
Overview
This skill provides real-time tracking for MiniMax API usage. It calculates usage based on prompts consumed, tracks remaining quota, and displays progress in a compact bar format. Designed for OpenClaw agents to monitor API usage between resets.
Features
- Real-time prompts usage tracking
- Visual progress bar with key metrics (RST/TTL/PKG/USE/REM/NXT)
- Automatic reset time calculation (15:00-20:00 UTC+8)
- JSON-based persistent storage
- Cron-ready for scheduled reminders
Usage
Commands
# Add usage (after API call)
python3 minimax_tracker.py add [n]
# View detailed status
python3 minimax_tracker.py status
# View compact progress bar
python3 minimax_tracker.py compact
Output Format
[████████████████████] 98% RST:18:00 TTL:1h40m PKG:Starter USE:2/40 REM:38 NXT:19:19
Integration with OpenClaw
# In your skill or agent code
import subprocess
# Track usage after each API call
result = subprocess.run(
["python3", "path/to/minimax_tracker.py", "add", "1"],
capture_output=True, text=True
)
Cron Setup (Every 3 Hours)
{
"name": "minimax-usage-check",
"schedule": "0 */3 * * *",
"payload": {
"kind": "agentTurn",
"message": "Run: python3 ~/openclaw-workspace/skills/openclaw-skill-minimax-tracker/minimax_tracker.py compact"
}
}
Configuration
Edit the CONFIG dict in minimax_tracker.py:
| Parameter | Default | Description |
|---|---|---|
| max_prompts | 40 | Monthly prompts limit |
| reset_hour_start | 15 | Reset window start (UTC+8) |
| reset_hour_end | 20 | Reset window end (UTC+8) |
| check_interval_hours | 3 | Reminder interval |
Data Storage
Usage data is stored in:
~/.openclaw/workspace/minimax_usage_data.json
Format:
{
"usage_records": [
{"time": "2026-02-27T16:19:00", "prompts": 1}
],
"current_usage": 2,
"last_reset": "2026-02-27T18:00:00",
"last_check": "2026-02-27T16:23:00"
}
Dependencies
- Python 3.8+ (standard library only, no pip packages needed)
Installation
# Copy to OpenClaw skills folder
cp -r openclaw-skill-minimax-tracker ~/openclaw-workspace/skills/
License
MIT License - See LICENSE file