antigravity-rotator

name	antigravity-rotator
description	Google Antigravity 模型全自动运维方案。提供多账号自动轮换、优先级调度、会话热更新以及赛博朋克风仪表盘。使用场景包括：(1) 自动化管理多个 Antigravity 账号，(2) 监控配额并自动切换，(3) 在不重启会话的情况下更新模型。

Antigravity Rotator (反重力轮换器) 🚀

本 Skill 旨在为 OpenClaw 提供一套确定性的 Google Antigravity 模型运维工作流。它将复杂的配额监控与自动化调度封装为简单的 Action。

🎯 触发场景 (When to use)

• 当用户拥有多个 Antigravity 账号且希望自动最大化利用配额时。
• 当主账号配额耗尽，需要无感切换（不重启会话）到备用账号时。
• 当需要实时可视化监控所有账号状态和轮换历史时。

🛠️ 快速部署流程 (Quick Start)

1. 环境初始化 (必须执行)

进入 Skill 目录并运行 setup 脚本：

cd skills/antigravity-rotator
node index.js --action=setup

作用：自动探测 openclaw 和 node 路径，并生成适配你系统的 config.json。

2. 启动管理看板

node index.js --action=dashboard

• 地址：http://localhost:18090
• 初始化账号：进入页面点击右上角 “同步凭证”，脚本会自动扫描并加载你已通过 openclaw models auth login 登录的账号。

3. 配置定时任务 (Cron)

为了让轮换全自动运行，必须在系统 crontab 中配置驱动：

# 每 10 分钟自动检查一次
*/10 * * * * [NODE_PATH] [SKILL_PATH]/index.js --action=rotate >> [LOG_PATH]/cron-rotate.log 2>&1

注：具体的路径请参考 node index.js --action=setup 运行后的输出结果。

📝 核心配置项详解 (config.json)

参数	类型	说明
openclawBin	String	关键。openclaw 的绝对路径。
modelPriority	Array	轮换优先级列表。排在前面的模型会被优先尝试。
quotas.low	Number	触发轮换的余量百分比阈值（建议 21）。
clientId	String	(高级) Google OAuth 客户端 ID。默认为 Antigravity 通用 ID。
clientSecret	String	(高级) Google OAuth 客户端密钥。
defaultProjectId	String	(高级) Google 项目 ID，影响配额查询接口。

🌟 核心特性

• 会话热更新：利用 OpenClaw Gateway API，在后台悄悄更换模型，用户正在进行的对话完全不受影响。
• 自动 Token 刷新：内置 Token 刷新逻辑，确保长期运行无需手动重新登录。
• 模型激活 (Warmup)：自动识别并激活“满血”但在计时外的模型，消除初次切换的延迟。
• 透明化日志：看板实时展示轮换原因（如：调度更优模型、当前余量不足等）。

🤖 开发者资源

• 入口: index.js
• 逻辑引擎: scripts/rotator.js (配额查询与账号调度)
• Web UI: scripts/dashboard.js (基于 http 模块的极简服务器)
• 模板: assets/ 文件夹下包含详细的 JSON 模板和 Cron 示例。

---

Antigravity Rotator - 你的 Antigravity 永不宕机 🥵