什么是 MiniMax 使用量监测器？

此技能为开发者提供了一个专业级的命令行工具，用于监测其 MiniMax 编程计划的消耗情况。通过调用官方 API，它可以让您追踪总可用额度、不同时间窗口内的当前使用量，以及下次额度重置的精确倒计时。将此工具集成到您的 Openclaw Skills 工作流中，可确保您对 AI 资源保持完全透明，并避免在关键开发阶段出现服务中断。

该工具设计可靠，可将 MiniMax 平台复杂的多窗口使用逻辑解析为简单、易读的状态报告。无论您使用的是 Plus 计划还是标准订阅，该技能都能通过提供有关额度可用性的实时数据，确保您的 AI 辅助编程环境平稳运行。

下载入口:https://github.com/openclaw/skills/tree/main/skills/weapon3k/minimax-usage-monitor

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

MiniMax 使用量监测器 应用场景

• 监测剩余的 MiniMax API 额度，防止在自动化编程任务中触及硬性限制。
• 将自动使用量检查集成到 Openclaw Skills 心跳文件中，进行定时状态更新。
• 以 JSON 格式导出实时订阅数据，以便与自定义开发者仪表盘集成。
• 当额度使用量超过分配限制的 80% 时，接收主动桌面通知。

1. 脚本安全地访问存储在系统环境变量中的 MiniMax 编程计划 API 密钥。
2. 向 MiniMax 官方开放平台端点发送请求，获取原始使用量和剩余额度数据。
3. 该技能执行逻辑计算，将使用情况映射到平台的 15 个 5 小时窗口中。
4. 它识别当前使用百分比，并计算到下一个窗口重置为止的剩余具体时间。
5. 数据将以清晰的状态指示器输出到控制台，或格式化为 JSON 对象以进行进一步的自动化处理。

MiniMax 使用量监测器 配置指南

1. 获取 API 密钥

访问 MiniMax 控制台 创建并复制您的编程计划密钥。

2. 配置环境变量

对于 Linux 或 macOS，将此内容添加到您的配置文件中：

export MINIMAX_CODING_KEY="your-api-key-here"

对于 Windows PowerShell（永久生效）：

[System.Environment]::SetEnvironmentVariable("MINIMAX_CODING_KEY", "your-api-key-here", "User")

3. 安装依赖项

pip install requests

MiniMax 使用量监测器 数据架构与分类体系

该技能将使用数据组织成以下结构，以便于监控：

minimax-usage

Monitor MiniMax Coding Plan usage via API. Check remaining prompts, usage percentage, and reset time.

Description

This skill provides a command-line tool to query your MiniMax Coding Plan usage through the official API. It displays:

• Total available prompts (based on your subscription)
• Current usage across all time windows
• Remaining prompts
• Time until next reset
• Warning alerts when usage exceeds 80%

Requirements

• Python 3.8+
• requests library
• Windows (for environment variable reading)
• MiniMax Coding Plan subscription
• MiniMax Coding Plan API Key

Setup

1. Get API Key

1. Visit MiniMax Console
2. Create a new Coding Plan Key
3. Copy the key

2. Set Environment Variable

Windows PowerShell (User-level, permanent):

[System.Environment]::SetEnvironmentVariable("MINIMAX_CODING_KEY", "your-api-key-here", "User")

Windows PowerShell (Session-level, temporary):

$env:MINIMAX_CODING_KEY = "your-api-key-here"

Linux/Mac:

export MINIMAX_CODING_KEY="your-api-key-here"

3. Install Dependencies

pip install requests

Usage

Basic Check

python check_minimax.py

With Notifications

python check_minimax.py --notify

JSON Output

python check_minimax.py --json

Output Example

=== MiniMax Coding Plan Usage ===
Model: MiniMax-M2
Total Available: 1,500 prompts
Used (all windows): 500 (33.3%)
Remaining: 1,000 prompts (66.7%)
Reset in: 2h 30m
Status: [OK]

Integration

Add to Heartbeat (OpenClaw)

In your HEARTBEAT.md:

### MiniMax Usage Check (Hourly)
- Run: python scripts/check_minimax.py --notify
- Alert: Less than 20% remaining

Cron Job (Linux/Mac)

# Add to crontab
0 * * * * /path/to/check_minimax.py --notify

Technical Details

• API Endpoint: https://www.minimaxi.com/v1/api/openplatform/coding_plan/remains
• Auth: Bearer token (Coding Plan API Key)
• Important: The API returns usage_count as REMAINING prompts, not used!
• Window Calculation: 15 x 5-hour windows (1500 total = 15 × 100 for Plus plan)
  • Total = 1500 prompts
  • Used = 1500 - usage_count
  • Current window = usage_count % 100

Files

minimax-usage/
├── SKILL.md              # This file
├── README.md             # Setup guide
├── check_minimax.py      # Main script
└── requirements.txt       # Python dependencies

License

MIT