Google AI 用量监控技能

监控 Google AI Studio 用量，防止配额耗尽并优化 API 消耗。

支持的指标

指标	描述	告警阈值
RPM	每分钟请求数（峰值）	> 限额的 80%
TPM

每分钟令牌数（峰值） | > 限额的 80% | | RPD | 每日请求数 | > 限额的 80% |

各层级速率限制

层级	典型限制
免费版	2 RPM, 32K TPM, 50 RPD
按量付费

10-15 RPM, 100K+ TPM, 500+ RPD | | 付费层级 1 | 20 RPM, 100K TPM, 250 RPD（因模型而异） |

注意：实际限制因模型而异，可在用量仪表板查看。

用量仪表板

URL

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

需提取的关键元素

• - 项目名称：哪个 GCP 项目
• 层级：免费版 / 按量付费 / 付费层级 X
• 模型表格：每行包含模型名称、类别、RPM、TPM、RPD
• 时间范围：默认 28 天

浏览器自动化

打开用量页面

javascript // 使用 OpenClaw 浏览器工具 browser action=open targetUrl=https://aistudio.google.com/usage?project=YOURPROJECTID&timeRange=last-28-days&tab=rate-limit profile=openclaw

等待数据加载

页面异步加载数据。等待：

1. 1. 项目下拉菜单显示项目名称（而非加载中...）
2. 速率限制表格包含数据行

解析表格数据

查找符合以下模式的行：

模型名称 | 类别 | X / Y | X / Y | X / Y | 查看图表

其中 X / Y 表示 已用量 / 限额。

报告格式

Discord 消息模板

markdown

📊 Google AI Studio 用量报告

项目: {project_name}
付费等级: {tier}
统计周期: 过去 28 天

---

{Model Name}

指标	用量	限额	使用率
RPM	{rpmused}	{rpmlimit}	{rpmpct}%
TPM

{tpmused} | {tpmlimit} | {tpmpct}% |

| RPD | {rpdused} | {rpdlimit} | {rpd_pct}% |

---

{statusemoji} 状态: {statustext}

检查时间: {timestamp}

状态等级

使用率	状态	表情符号	操作
< 50%	正常	✅	继续正常使用
50-80%

需关注 | ⚠️ | 提高监控频率 | | > 80% | 风险预警 | 🚨 | 提醒用户，考虑限流 |

告警规则

何时提醒用户

1. 1. 任一指标 > 80%：立即告警并 @提及
2. 任一指标 > 50%：在报告中包含警告说明
3. API 错误 (429)：记录速率限制命中情况

告警消息模板

markdown
🚨 Google AI 配额预警

<@USER_ID> 以下指标接近限额：

• - {model} {metric}: {used}/{limit} ({pct}%)

建议：

• - 减少 API 调用频率
• 考虑升级付费等级
• 检查是否有异常调用

定时任务设置

每日检查（推荐）

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

与 OpenClaw 集成

配置

添加到 TOOLS.md：

markdown

Google AI Studio

• - 项目 ID: gen-lang-client-XXXXXXXXXX
• 仪表板: https://aistudio.google.com/usage
• Discord 频道: #google-ai (CHANNEL_ID)
• 检查计划: 每日 20:00

心跳集成

添加到 HEARTBEAT.md：

markdown

Google AI 监控

• - 如果上次检查超过 24 小时，则检查用量
• 如果任一指标 > 80%，则发出告警

故障排除

页面无法加载

1. 1. 检查是否登录了正确的 Google 账号
2. 验证项目 ID 是否正确
3. 等待异步数据加载更长时间（5-10 秒）

数据显示加载中...

项目下拉菜单可能需要时间填充。几秒后重试截图。

指标未更新

Google 说明：用量数据可能需要最多 15 分钟才能更新。

参考

• - Google AI Studio 用量仪表板
• Gemini API 速率限制
• 计费文档
• Gemini 的 Cloud 监控