xAI Prepaid Monitor — xAI 预付监控器
v1.0.0使用可重用的Python脚本和警报工作流监控xAI预付信用余额。当设置或排除xAI/Grok使用中的低信用检查问题、构建在预付余额阈值时警告的cron jobs或创建当xAI信用不足时的后续自动化(如Discord警报或任务创建)时使用。
0· 0·0 当前·0 累计
下载技能包
License
MIT-0
运行时依赖
无特殊依赖
安装命令
点击复制官方npx clawhub@latest install xai-prepaid-monitor
镜像加速npx clawhub@latest install xai-prepaid-monitor --registry https://cn.longxiaskill.com镜像同步中
技能文档
使用此技能将可重用的xAI预付余额检查添加到OpenClaw设置中。该技能提供以下内容:
- scripts/check_xai_balance.py:一个小脚本,用于查询xAI Management API并返回标准化的JSON
- 一个参考文件,包含cron提示模式:仅警报监控、警报 + 后续任务创建
环境要求: 在使用脚本之前,在OpenClaw配置或运行时环境中设置以下环境变量:
- XAI_TEAM_ID
- XAI_MANAGEMENT_KEY
- XAI_BALANCE_WARN_BELOW_CENTS(默认300)
- XAI_BALANCE_CRITICAL_BELOW_CENTS(默认200)
运行脚本: 使用:/usr/bin/python3 /path/to/skills/xai-prepaid-monitor/scripts/check_xai_balance.py 脚本输出JSON,如下所示: { "ok": true, "status": "warn", "total_cents": 700, "used_cents": 450, "remaining_cents": 250, "total": "$7.00", "used": "$4.50", "remaining": "$2.50", "warn_below": "$3.00", "critical_below": "$2.00", "billing_cycle": "..." }
输出合同: 解释结果的方式:
- ok=false:检查失败,简要显示错误
- status=ok:无需操作
- status=warn:剩余余额低于警告阈值
- status=critical:剩余余额低于临界阈值
推荐工作流程:
- 运行脚本并执行
- 解析JSON输出
- 如果ok=false,发送短暂的失败警报
- 如果status=ok,保持静默或记录成功
- 如果status=warn或critical,发送简洁的警报
- 可选地在用户的任务系统中创建后续任务
Cron设置:
- 读取references/cron-examples.md以获取提示模式
防护栏:
- 将交付逻辑与脚本分开
- 脚本应仅获取和标准化余额数据
- 不要将Discord频道ID、Todoist路径或用户特定的路由硬编码到脚本中
- 更改xAI API合同时,请同时更新脚本和示例
- 优先使用环境变量设置阈值,以便同一脚本可在不同设置中工作。