MiniMax Token Plan Usage Monitor

---

name: minimax-token-plan-monitor description: MiniMax Token Plan 用量监控 — 专为云部署龙虾（OpenClaw）设计，自动查询本周/5小时窗口用量、套餐余量、剩余调用次数及重置时间。支持 QQ/Discord/Telegram 多通道通知，可配置告警阈值。触发词：minimax额度查询、token plan用量、本周用量、剩余次数、订阅状态、minimax coding plan、minimax配额。

---

MiniMax Token Plan 用量监控 📊

监控 MiniMax Token Plan 订阅套餐的实时用量，支持多通道通知和告警阈值配置。

功能特性

🔄 自动查询：5小时窗口 + 本周用量同时监控

🔔 多通道通知：支持 QQ / Discord / Telegram 推送

⚙️ 告警阈值：可配置用量百分比告警

⏰ 定时巡检：通过 cronjob 实现每日定时检查

🇨🇳 国内适配：针对国内版 MiniMax 平台优化

---

环境配置

在 ~/.env 中配置以下变量：

# MiniMax 账号（账号 + 密码）
MINIMAX_PHONE=your_account_here
MINIMAX_PASSWORD=your_password_here
通知配置（可选，留空则只输出日志）
QQBOT_PORT=37701
QQ/Discord/Telegram 通知通过 OpenClaw 消息通道发送

---

快速使用

手动查询

cd ~/.openclaw/workspace/skills/minimax-token-plan/scripts
node get_token_plan_usage.js

> 依赖 ~/.env 中的账号信息运行

输出示例

📊 MiniMax Token Plan 用量报告
⏰ 2026/4/4 22:00:21
🏷️ 套餐: Starter
📌 5小时窗口: 4 / 600 (1%)
📌 本周: 1398 / 6000 (23%)
🔄 25 小时 59 分钟后重置

JSON 原始输出

{
  "success": true,
  "data": {
    "url": "https://platform.minimaxi.com/user-center/payment/token-plan",
    "plan": "Starter",
    "fiveHour": { "used": 4, "limit": 600, "usedPercent": 1 },
    "week": { "used": 1398, "limit": 6000, "usedPercent": 23 },
    "resetTime": "25 小时 59 分钟后重置"
  }
}

---

定时任务配置（cron）

推荐监控时间点：每天 10/12/14/16/18/20/22 点

# 在 OpenClaw 配置中设置 cron
0 10,12,14,16,18,20,22 * * * /usr/bin/node /root/.openclaw/workspace/skills/minimax-token-plan/scripts/get_token_plan_usage.js >> /root/.openclaw/workspace/skills/minimax-token-plan/cron.log 2>&1

---

告警阈值配置

在 scripts/config.json 中修改：

{
  "alertThreshold": {
    "fiveHourPercent": 80,
    "weekPercent": 80
  }
}

当用量超过阈值时，会在通知中突出显示 ⚠️ 警告。

---

限速说明

| 窗口 | 套餐 | 说明 | |------|------|------| | 5小时 | 600次 | Starter 套餐限制 | | 本周 | 6000次 | 自然周统计，重置时间见输出 |

> 1次 API 调用 ≈ 1次模型请求

---

依赖

Node.js + Playwright

Chromium 浏览器（自动安装）

.env 配置文件（账号凭证）

---

故障排查

| 问题 | 解决方案 | |------|---------| | 登录失败 | 检查手机号 + 密码是否正确 | | 页面解析失败 | MiniMax 可能更新了页面结构，需更新正则 | | 滑动验证码 | 当前版本暂不支持，可尝试增加运行间隔 | | 通知发送失败 | 检查 QQBot 端口配置（默认 37701） |

---

> 💡 需要在 OpenClaw 中配置 MiniMax 账号的 cookie/token 才能实现免登录，具体咨询 MiniMax 官方文档。