API Quota Monitor

各種 API プロバイダーとサブスクリプションサービスの割り当て/残高/消費量を照会・監視します。

快速使用

# 設定済みのすべてのプロバイダーを照会
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

ワークフロー

1. ローカルで設定済みの API/プロバイダーを検出 (環境変数、auth-session-state.json から)
   ↓
2. タイプ別に照会：API 直接照会 > ブラウザスクレイピング
   ↓
3. レポートを生成：プロバイダー | 消費量 | 総割り当て | 状態

プロバイダー分類

公式プロバイダー (Official)

中継ステーション (Reseller)

中継ステーションの照会フロー：

1. ~/.openclaw/auth-session-state.json をチェックしてログイン状態を取得
2. browser(action='navigate', profile='openclaw') を使用してコンソールにアクセス
3. スナップショットから残高/消費量情報を抽出

サブスクリプションサービス (Services)

ブラウザ照会 (ブラウザスクレイピングが必要なプロバイダー)

プロバイダーが公開の usage API を持たない場合、browser ツールを使用します。

# 1. コンソールページに移動
browser(action='navigate', profile='openclaw', targetUrl='<console_url>')

# 2. ロードを待ってからスナップショットを取得
browser(action='snapshot', profile='openclaw', compact=true, maxChars=2000)

# 3. スナップショットから残高/消費量情報を抽出
# 検索キーワード：余额、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 エンドポイントと応答形式については、references/providers.md を参照してください。