SKILL.md - MiniMax 使用量追踪器

技能信息

• 技能名称: openclaw-skill-minimax-tracker
• 版本: 1.0.0
• 作者: QiaoTuCodes (Weiran), Yanyan
• 描述: 为 OpenClaw 提供 MiniMax API 使用量追踪与监控，支持进度条显示及用量提醒
• 代码仓库: https://github.com/QiaoTuCodes/openclaw-skill-minimax-tracker

概述

该技能提供 MiniMax API 使用量的实时追踪能力。它基于已消耗的 prompts 进行用量计算，持续跟踪剩余配额，并以紧凑的进度条形式展示当前状态。专为 OpenClaw 智能体设计，用于在配额重置周期之间监控 API 使用情况。

功能特性

• 实时 prompts 使用量追踪
• 可视化进度条，包含关键指标（RST/TTL/PKG/USE/REM/NXT）
• 自动计算重置时间（UTC+8 时区，每日 15:00–20:00）
• 基于 JSON 的持久化存储
• 支持 cron 定时提醒

使用方法

命令

# 添加使用量（调用 API 后执行）
python3 minimax_tracker.py add [n]

# 查看详细状态
python3 minimax_tracker.py status

# 查看紧凑型进度条
python3 minimax_tracker.py compact

输出格式

[████████████████████] 98% RST:18:00 TTL:1h40m PKG:Starter USE:2/40 REM:38 NXT:19:19

与 OpenClaw 集成

# 在您的技能或智能体代码中
import subprocess

# 每次 API 调用后追踪用量
result = subprocess.run(
    ["python3", "path/to/minimax_tracker.py", "add", "1"],
    capture_output=True, text=True
)

Cron 设置（每 3 小时一次）

{
  "name": "minimax-usage-check",
  "schedule": "0 */3 * * *",
  "payload": {
    "kind": "agentTurn",
    "message": "Run: python3 ~/openclaw-workspace/skills/openclaw-skill-minimax-tracker/minimax_tracker.py compact"
  }
}

配置项

编辑 minimax_tracker.py 中的 CONFIG 字典：

数据存储

使用量数据存储于：

~/.openclaw/workspace/minimax_usage_data.json

文件格式示例：

{
  "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"
}

依赖项

• Python 3.8+（仅依赖标准库，无需额外 pip 包）

安装方法

# 复制至 OpenClaw 技能目录
cp -r openclaw-skill-minimax-tracker ~/openclaw-workspace/skills/

许可证

MIT 许可证 — 详见 LICENSE 文件