api-quota-monitor

用途

API Quota Monitor 用于集中查询和监控各类 API 供应商及订阅服务的额度、余额和消耗情况，帮助用户及时掌握各服务的剩余用量。

主要能力

工具按供应商类型分为三类，查询方式与支持状态如下。

官方供应商（Official）

供应商	查询方式	环境变量	状态
ZAI（智谱）	API 直查	`ZAI_API_KEY`	支持
Minimax	API 直查	`MINIMAX_API_KEY` + `MINIMAX_GROUP_ID`	支持
OpenRouter	API 直查	`OPENROUTER_API_KEY`	支持
xAI（Grok）	浏览器	`XAI_API_KEY`	需浏览器
Gemini	浏览器	`GOOGLE_API_KEY`	需浏览器
Anthropic	浏览器	`ANTHROPIC_API_KEY`	需浏览器

中转站（Reseller）

平台	查询方式	状态来源
AIXN	浏览器抓取 ai.9w7.cn	auth-session-state.json
Provider-A	浏览器抓取 your-provider.example.com	auth-session-state.json

中转站查询流程：检查 ~/.openclaw/auth-session-state.json 获取登录状态，使用 browser(action='navigate', profile='openclaw') 访问控制台，从 snapshot 提取余额或消耗信息。

订阅服务（Services）

服务	查询方式	环境变量
Brave Search API	API 直查	`BRAVE_API_KEY`
Tavily API	API 直查	`TAVILY_API_KEY`
Serper API	API 直查	`SERPER_API_KEY`

使用方式

使用命令行脚本查询：

# 查询所有已配置的供应商
python3 scripts/query_quota.py

# 查询特定供应商
python3 scripts/query_quota.py xai
python3 scripts/query_quota.py openrouter
python3 scripts/query_quota.py brave

# 只查官方供应商
python3 scripts/query_quota.py --type official

# 只查订阅服务
python3 scripts/query_quota.py --type service

# JSON 输出
python3 scripts/query_quota.py --format json

# 发现已配置的供应商
python3 scripts/query_quota.py --discover

工作流：发现本地已配置的 API 或供应商（从环境变量、auth-session-state.json）→ 按类型查询（API 直查优先于浏览器抓取）→ 生成报告，包含供应商、消耗、总额度和状态。

对于需浏览器抓取的供应商，操作步骤为：

导航到控制台页面：

browser(action='navigate', profile='openclaw', targetUrl='<console_url>')

等待加载后获取快照：

browser(action='snapshot', profile='openclaw', compact=true, maxChars=2000)

从快照中提取余额或消耗信息，查找关键词：余额、balance、usage、消耗、tokens、额度。

各供应商控制台 URL：

xAI：https://console.x.ai/usage
Gemini：https://aistudio.google.com/apikey
Anthropic：https://console.anthropic.com/settings/billing
AIXN：https://ai.9w7.cn/console
Provider-A：https://your-provider.example.com/dashboard

报告格式示例：

📊 API Quota Report
⏰ 2026-03-15 20:30

━━ 官方供应商 ━━
✅ ZAI (智谱): ¥50.00
✅ Minimax: ¥10.00 CNY
✅ OpenRouter: $45.00 remaining
🔍 xAI (Grok): 需浏览器查询

━━ 订阅服务 ━━
✅ Brave Search: 1500/2000 requests
✅ Tavily: 800 remaining

━━ 中转站 ━━
✅ AIXN: ¥238.81
✅ Provider-A: ¥9.35

扩展新供应商

在 scripts/query_quota.py 中添加新供应商配置：

OFFICIAL_PROVIDERS = {
    "new_provider": {
        "name": "New Provider",
        "env_key": "NEW_PROVIDER_API_KEY",
        "api_url": "https://api.newprovider.com/v1/usage",
        "method": "api",  # 或 "browser"
        "extract": lambda data: {
            "balance": data.get("balance", 0),
        }
    },
}

缓存策略

API 查询结果可缓存 1-6 小时（避免频繁请求）。缓存文件为 ~/.openclaw/quota-cache.json，格式如下：

{
  "openrouter": {
    "queried_at": "2026-03-15T20:00:00",
    "balance": 45.0,
    "cached": true
  }
}

定时监控

可配置 cron 定期检查并推送报告：

# 在 OpenClaw cron 中添加
# 每 6 小时检查一次 API 供应商额度
0 */6 * * * python3 ~/clawd/skills/api-quota-monitor/scripts/query_quota.py --report | newsbot_send

适用场景与限制

适用于需要集中掌握多个 API 供应商、中转站和订阅服务余额及用量的用户，尤其适合在额度不足前及时获知。部分供应商（xAI、Gemini、Anthropic）及中转站需通过浏览器抓取控制台信息，依赖登录状态文件。工具支持扩展新供应商、结果缓存和定时监控。详细的 API 端点和响应格式见 references/providers.md。