Integration
Antigravity Oauth
OpenClaw plugin β Google Antigravity OAuth for Gemini 3 Pro, Claude Opus 4.6, Sonnet 4.6. No API key required.
Install
npm install --production
Configuration Example
{
"plugins": {
"entries": {
"opencode-antigravity-auth": {
"enabled": true
}
}
}
}
README
<p align="center">
<img src="https://img.shields.io/badge/π_OpenClaw_Antigravity_OAuth-Plugin-blueviolet?style=for-the-badge&labelColor=1a1a2e" alt="OpenClaw Antigravity OAuth Plugin" />
</p>
<h3 align="center">Access Gemini 3 Pro Β· Gemini 3.1 Pro Β· Gemini 3 Flash Β· Claude Opus 4.6 Β· Sonnet 4.6<br/>in OpenClaw β No API Key Required</h3>
<p align="center">
<a href="https://buymeacoffee.com/wbbt"><img src="https://img.shields.io/badge/β_Support_This_Project-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black" alt="Buy Me A Coffee" /></a>
</p>
<p align="center">
<a href="https://github.com/wbbtmusic/openclaw-antigravity-oauth/stargazers"><img src="https://img.shields.io/github/stars/wbbtmusic/openclaw-antigravity-oauth?style=flat-square&color=yellow" /></a>
<a href="https://github.com/wbbtmusic/openclaw-antigravity-oauth/network/members"><img src="https://img.shields.io/github/forks/wbbtmusic/openclaw-antigravity-oauth?style=flat-square&color=blue" /></a>
<a href="https://github.com/wbbtmusic/openclaw-antigravity-oauth/issues"><img src="https://img.shields.io/github/issues/wbbtmusic/openclaw-antigravity-oauth?style=flat-square&color=orange" /></a>
<img src="https://img.shields.io/badge/OpenClaw-v2026.2.x-brightgreen?style=flat-square" />
<img src="https://img.shields.io/badge/License-MIT-green?style=flat-square" />
<img src="https://img.shields.io/badge/Node.js-18+-339933?style=flat-square&logo=node.js&logoColor=white" />
</p>
---
Google removed the built-in `google-antigravity-auth` provider from **OpenClaw v2026.2.x**. This plugin brings it back as an external extension β authenticate with your Google account via OAuth and use Antigravity's full model catalog directly in OpenClaw.
> **π Zero API keys Β· Zero cost Β· Just your Google account**
---
## β οΈ IMPORTANT β Risk of Account Restriction
> [!CAUTION]
> **Using this plugin may violate Google's Terms of Service.**
> A small number of users have reported their Google accounts being **banned or shadow-banned** when using unofficial Antigravity integrations.
| Risk Level | Scenario |
|:---:|---|
| π΄ **VERY HIGH** | Fresh / new Google accounts |
| π΄ **HIGH** | New accounts with Pro/Ultra subscriptions |
| οΏ½ **MODERATE** | Excessive API usage or unusual traffic patterns |
| π’ **LOWER** | Established accounts with normal usage |
**By using this plugin, you acknowledge:**
- β This is an **unofficial tool**, not endorsed by Google
- β Your Google account **may be suspended or permanently banned**
- β You **assume all risks** associated with using this plugin
- β The authors are **not responsible** for any consequences
> π‘ **Recommendation:** Use an established Google account that you don't rely on for critical services.
---
## π― Available Models
<table>
<tr>
<th colspan="4" align="center">π£ Antigravity Quota β Google Models</th>
</tr>
<tr><th>Model ID</th><th>Name</th><th>Context</th><th>Max Output</th></tr>
<tr><td><code>gemini-3-pro-high</code></td><td>Gemini 3 Pro (High Thinking)</td><td>1M</td><td>65K</td></tr>
<tr><td><code>gemini-3-pro-low</code></td><td>Gemini 3 Pro (Low Thinking)</td><td>1M</td><td>65K</td></tr>
<tr><td><code>gemini-3.1-pro-high</code></td><td>Gemini 3.1 Pro (High)</td><td>1M</td><td>65K</td></tr>
<tr><td><code>gemini-3.1-pro-low</code></td><td>Gemini 3.1 Pro (Low)</td><td>1M</td><td>65K</td></tr>
<tr><td><code>gemini-3-flash</code></td><td>Gemini 3 Flash</td><td>1M</td><td>65K</td></tr>
<tr>
<th colspan="4" align="center">π΅ Antigravity Quota β Claude Models (via Google)</th>
</tr>
<tr><th>Model ID</th><th>Name</th><th>Context</th><th>Max Output</th></tr>
<tr><td><code>claude-opus-4-6-thinking</code></td><td>Claude Opus 4.6 (Thinking)</td><td>200K</td><td>64K</td></tr>
<tr><td><code>claude-opus-4-5-thinking</code></td><td>Claude Opus 4.5 (Thinking)</td><td>200K</td><td>64K</td></tr>
<tr><td><code>claude-sonnet-4-6</code></td><td>Claude Sonnet 4.6</td><td>200K</td><td>64K</td></tr>
</table>
> All models accessed via **Google Antigravity's OAuth** β no API keys, no billing.
---
## π Quick Start
### Option A β One-Line Install
```bash
curl -sL https://raw.githubusercontent.com/wbbtmusic/openclaw-antigravity-oauth/main/install.sh | bash
```
Then authenticate:
```bash
openclaw models auth login --provider google-antigravity
```
### Option B β Manual Install
<details>
<summary><strong>π Click to expand step-by-step instructions</strong></summary>
#### Step 1 β Clone the Repository
```bash
git clone https://github.com/wbbtmusic/openclaw-antigravity-oauth.git \
~/.openclaw/extensions/opencode-antigravity-auth
cd ~/.openclaw/extensions/opencode-antigravity-auth
```
#### Step 2 β Install Dependencies
```bash
npm install --production
```
#### Step 3 β Add Plugin to Config
Edit `~/.openclaw/openclaw.json`:
```jsonc
{
"plugins": {
"entries": {
"opencode-antigravity-auth": {
"enabled": true
}
}
}
}
```
> β οΈ **Remove** any old `google-antigravity-auth` entry β that was the bundled version.
#### Step 4 β Add Models to Config
In `agents.defaults.models`:
```jsonc
"google-antigravity/gemini-3-pro-high": {},
"google-antigravity/gemini-3-pro-low": {},
"google-antigravity/gemini-3.1-pro-high": {},
"google-antigravity/gemini-3.1-pro-low": {},
"google-antigravity/gemini-3-flash": {},
"google-antigravity/claude-opus-4-6-thinking": {},
"google-antigravity/claude-opus-4-5-thinking": {},
"google-antigravity/claude-sonnet-4-6": {}
```
Set fallbacks:
```jsonc
"model": {
"primary": "google-antigravity/gemini-3-flash",
"fallbacks": [
"google-antigravity/gemini-3.1-pro-high",
"google-antigravity/claude-opus-4-6-thinking"
]
}
```
</details>
---
## π Authentication Flow
```
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β YOUR TERMINAL (SSH) β
β β
β $ openclaw models auth login --provider google-antigravity β
β β
β π Open this URL in your browser: β
β https://accounts.google.com/o/oauth2/v2/auth?... β
β β
β Paste redirect URL: β β
ββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββ
β
ββββββββΌβββββββ
β BROWSER β
β (any PC) β
βββββββββββββββ€
β 1. Open URL β
β 2. Sign in β
β Google β
β 3. Copy the β
β redirect β
β URL β
ββββββββ¬βββββββ
β
ββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββ
β Paste redirect URL: http://localhost:51121/oauth-callb... β
β β
β π Exchanging token... β
β β
Token received! β
β β
OAuth successful! Email: [email protected] β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
```
### π₯οΈ Headless Server (VPS / No Browser)
1. Run the auth command on your server
2. Copy the OAuth URL from the terminal
3. Open it in a browser **on your local machine**
4. After signing in, the browser redirects to `localhost:51121/...`
- The page will fail to load β **that's expected!**
5. Copy the URL from the address bar anyway
6. Paste it back in the SSH terminal
---
## π Post-Authentication
```bash
# Restart gateway
openclaw gateway restart # or: pm2 restart openclaw
# Verify models
openclaw models list | grep antigravity
# Set default model (optional)
openclaw config set agents.defaults.model.primary google-antigravity/gemini-3-flash
```
---
## π οΈ Troubleshooting
<details>
<summary><strong>"plugin removed: google-antigravity-auth"</strong></summary>
This means you still have the old bundled plugin entry. Remove it:
```bash
nano ~/.openclaw/openclaw.json
# Delete "google-antigravity-auth" from plugins.entries
# Keep "opencode-antigravity-auth"
```
</details>
<details>
<summary><strong>"Unknown provider: google-antigravity"</strong></summary>
Checklist:
- [ ] Plugin files in `~/.openclaw/extensions/opencode-antigravity-auth/`
- [ ] `npm install` was run in the plugin directory
- [ ] `openclaw.plugin.json` exists
- [ ] OpenClaw was restarted
</details>
<details>
<summary><strong>OAuth redirect fails on headless server</strong></summary>
The redirect goes to `localhost:51121` β on a headless server this won't open. Copy the URL from your browser's address bar (even if the page shows an error) and paste it in the terminal.
</details>
<details>
<summary><strong>"invalid_grant" error</strong></summary>
Authorization code expired. Run the auth flow again β codes are single-use and expire quickly.
</details>
---
## π Project Structure
```
opencode-antigravity-auth/
βββ π openclaw-entry.js # OpenClaw wrapper (register API bridge)
βββ π openclaw.plugin.json # Plugin manifest
βββ π¦ package.json # npm config + openclaw.extensions
βββ π install.sh # One-line installer
βββ π LICENSE # MIT
βββ π README.md # This file
βββ π dist/ # Core OAuth (from opencode-antigravity-auth)
βββ src/
βββ antigravity/oauth.js # Google OAuth PKCE flow
βββ constants.js # Client IDs, endpoints
βββ plugin.js # Original plugin logic
```
---
## βοΈ How It Works
```
βββββββββββββββββ ββββββββββββββββββββ βββββββββββββββββββ
β OpenClaw ββββββΆβ openclaw-entry ββββββΆβ Google OAuth β
β register() β β .js (wrapper) β β PKCE Flow β
βββββββββββββββββ βββββββββ
... (truncated)
integration
Comments
Sign in to leave a comment