OpenClaw Antigravity Sync Skill

核心用法

Antigravity Sync 是一款面向 OpenClaw 用户的自动化配置工具，专门用于管理 Google Antigravity AI 模型的发现与同步。用户通过简单的命令触发（如 sync antigravity 或 update models），即可自动完成以下操作：

1. API 查询：调用 Google Cloud Code Assist API 的 fetchAvailableModels 端点，获取当前账户可用的全部模型及其配额状态
2. 智能筛选：自动过滤掉已耗尽配额（exhausted）的模型，仅保留可正常使用的资源
3. 配置更新：将获取的模型列表写入 openclaw.json 的 models.providers["google-antigravity"].models 字段
4. 默认模型设置：自动将 API 推荐的默认模型设为 agents.defaults.model.primary，同时尊重用户的已有手动选择
5. 安全备份：在修改配置文件前自动创建备份，防止配置丢失

显著优点

• 零配置上手：无需手动编辑 JSON 文件，降低配置错误风险
• 实时同步：确保本地配置与 Google 云端可用模型保持同步
• 配额感知：自动剔除不可用模型，避免调用失败
• 非侵入式设计：保留现有认证设置和用户手动指定的模型偏好
• Node.js 运行时：执行效率高，依赖轻量

潜在缺点与局限性

• 单一供应商锁定：仅支持 Google Antigravity，无法同步其他提供商（如 OpenAI、Anthropic）的模型
• 触发方式受限：仅支持命令行触发，无自动定时同步机制
• 权限依赖：必须预先完成 google-antigravity OAuth 认证，否则无法运行
• 配置格式固定：假设用户严格使用标准的 openclaw.json 结构，自定义路径或格式可能不兼容
• 网络依赖：完全依赖 Google API 可用性，无离线缓存或降级方案

适合人群

• 使用 OpenClaw 框架并接入 Google Antigravity API 的开发者
• 需要频繁切换模型或管理多模型配额的团队
• 希望减少手动配置维护工作的 DevOps/平台工程师

常规风险

• 认证令牌泄露：虽然脚本本身不存储凭证，但运行时需访问 OAuth 令牌，建议在受控环境中执行
• 配置覆盖风险：尽管有备份机制，但频繁同步仍可能意外覆盖手动调整的高级配置
• API 限流：频繁调用 fetchAvailableModels 可能触发 Google Cloud 的速率限制
• 版本兼容性：API 响应格式变更可能导致解析失败，需关注 Google 官方更新日志