Minimax Usage (国内版)

Monitor Minimax Coding Plan usage to stay within API limits.

目录结构

~/.openclaw/workspace/skills/minimax-usage-cn/
├── SKILL.md
└── scripts/
    └── minimax-usage.sh   # Main script

功能

• Check current usage quota
• Monitor 5-hour sliding window
• Get usage alerts before hitting limits

When to Use This Skill

Use this skill whenever:

• User asks to check Minimax usage
• Before running large AI tasks
• When approaching limit warnings

API Specification

Endpoint: GET https://www.minimaxi.com/v1/api/openplatform/coding_plan/remains

Headers:

Authorization: Bearer <MINIMAX_API_KEY>
Content-Type: application/json

注意： 此接口仅适用于国内版 www.minimaxi.com。

Response Fields

计算公式（重要！）

# ❌ 错误理解
已用 = current_interval_usage_count  # 误以为这是"已用量"

# ✅ 正确理解
剩余 = current_interval_usage_count  # 这是"剩余可用次数"
已用 = current_interval_total_count - current_interval_usage_count
使用率 = (current_interval_total_count - current_interval_usage_count) / current_interval_total_count * 100%

示例：API 返回 current_interval_total_count=1500, current_interval_usage_count=1263

• 剩余 = 1263 次
• 已用 = 1500 - 1263 = 237 次
• 使用率 = 237 / 1500 = 15.8%

状态阈值

Output Format

🔍 Checking Minimax Coding Plan usage...
✅ Usage retrieved successfully:

📊 Coding Plan Status (MiniMax-M2.5):
   Used:      102 / 1500 prompts (6%)
   Remaining: 1398 prompts
   Window:    20:00 - 00:00 (UTC+8)
   Resets in: 约 1h 13m

💚 GREEN: 6% used. Plenty of buffer.

JSON Output Mode

For programmatic use, add --json or -j flag:

./minimax-usage.sh --json

Output:

{
  "status": "GREEN",
  "used": 102,
  "total": 1500,
  "remaining": 1398,
  "percent": 6,
  "model": "MiniMax-M2.5",
  "window_start": "20:00",
  "window_end": "00:00",
  "resets_in_seconds": 4380
}

Cron 定时检查

添加到 crontab 每小时检查一次：

# 编辑 crontab
crontab -e

# 添加以下行（每小时检查并记录）
0 * * * * cd /home/rocfly/.openclaw/workspace/skills/minimax-usage-cn/scripts && ./minimax-usage.sh >> /home/rocfly/.openclaw/workspace/logs/minimax-usage.log 2>&1

# 或者带通知（需要配置邮件或 webhook）
0 * * * * cd /home/rocfly/.openclaw/workspace/skills/minimax-usage-cn/scripts && ./minimax-usage.sh --json | python3 -c "
import sys, json
data = json.load(sys.stdin)
if data['percent'] > 75:
    print(f'⚠️ ALERT: {data[\"percent\"]}% used!')
    # 在此添加 webhook 通知
"

常见使用场景

Status Thresholds

Notes

• 需要使用 Coding Plan API Key, 专用于 Coding Plan 套餐
• Coding Plan 用量每5小时重置
• 一个 prompt 约等于 15 次模型调用
• current_interval_usage_count 是剩余用量，不是已用量！
• 窗口时间为 UTC+8 时区

Error Handling