Google AI Usage Monitor

Google AI Usage Monitor Skill

Monitor Google AI Studio usage to prevent quota exhaustion and optimize API consumption.

Supported Metrics

MetricDescriptionAlert ThresholdRPMRequests Per Minute (peak)> 80% of limitTPMTokens Per Minute (peak)> 80% of limitRPDRequests Per Day> 80% of limit

Rate Limits by Tier

TierTypical LimitsFree2 RPM, 32K TPM, 50 RPDPay-as-you-go10-15 RPM, 100K+ TPM, 500+ RPDPaid Tier 120 RPM, 100K TPM, 250 RPD (varies by model) Note: Actual limits vary by model and can be viewed at the usage dashboard.

URL

https://aistudio.google.com/usage?project={PROJECT_ID}&timeRange=last-28-days&tab=rate-limit

Key Elements to Extract

Project name: Which GCP project Tier: Free / Pay-as-you-go / Paid tier X Models table: Each row contains model name, category, RPM, TPM, RPD Time range: Default 28 days

Open Usage Page

// Using OpenClaw browser tool browser action=open targetUrl="https://aistudio.google.com/usage?project=YOUR_PROJECT_ID&timeRange=last-28-days&tab=rate-limit" profile=openclaw

Wait for Data Load

The page loads data asynchronously. Wait for: Project dropdown shows project name (not "Loading...") Rate limits table has data rows

Parse Table Data

Look for table rows with pattern: Model Name | Category | X / Y | X / Y | X / Y | View in charts Where X / Y represents used / limit.

Discord Message Template

## 📊 Google AI Studio 用量报告 **项目**: {project_name} **付费等级**: {tier} **统计周期**: 过去 28 天 --- ### {Model Name} | 指标 | 用量 | 限额 | 使用率 | |------|------|------|--------| | RPM | {rpm_used} | {rpm_limit} | {rpm_pct}% | | TPM | {tpm_used} | {tpm_limit} | {tpm_pct}% | | RPD | {rpd_used} | {rpd_limit} | {rpd_pct}% | --- {status_emoji} **状态**: {status_text} *检查时间: {timestamp}*

Status Levels

Usage %StatusEmojiAction< 50%正常✅Continue normally50-80%需关注⚠️Monitor more frequently> 80%风险预警🚨Alert user, consider rate limiting

When to Alert User

Any metric > 80%: Immediate alert with @mention Any metric > 50%: Include warning note in report API errors (429): Track rate limit hits

Alert Message Template

• 🚨 **Google AI 配额预警**
• <@USER_ID> 以下指标接近限额：
• **{model}** {metric}: {used}/{limit} ({pct}%)
• 建议：
• 减少 API 调用频率
• 考虑升级付费等级
• 检查是否有异常调用

Daily Check (Recommended)

{ "name": "Google AI 用量检查", "schedule": { "kind": "cron", "expr": "0 20 * * *", "tz": "Asia/Shanghai" }, "sessionTarget": "isolated", "payload": { "kind": "agentTurn", "message": "检查 Google AI Studio 用量并发送报告到指定 Discord 频道" }, "delivery": { "mode": "announce", "channel": "discord", "to": "CHANNEL_ID" } }

Configuration

• Add to TOOLS.md:
• ## Google AI Studio
• **Project ID**: gen-lang-client-XXXXXXXXXX
• **Dashboard**: https://aistudio.google.com/usage
• **Discord Channel**: #google-ai (CHANNEL_ID)
• **Check Schedule**: Daily 20:00

Heartbeat Integration

• Add to HEARTBEAT.md:
• ## Google AI Monitoring
• Check usage if last check > 24 hours
• Alert if any metric > 80%

Page Not Loading

Check if logged into correct Google account Verify project ID is correct Wait longer for async data load (5-10 seconds)

Data Shows "Loading..."

The project dropdown may take time to populate. Retry snapshot after a few seconds.

Metrics Not Updating

Google notes: "Usage data may take up to 15 minutes to update."

References

Google AI Studio Usage Dashboard Gemini API Rate Limits Billing Documentation Cloud Monitoring for Gemini