skills$openclaw/nano-banana-antigravity
cgnl3.1k

by cgnl

nano-banana-antigravity – OpenClaw Skill

nano-banana-antigravity is an OpenClaw Skills integration for coding workflows. Generate or edit images via Nano Banana Pro using Antigravity OAuth (no API key needed!)

3.1k stars9.7k forksSecurity L1
Updated Feb 7, 2026Created Feb 7, 2026coding

Skill Snapshot

namenano-banana-antigravity
descriptionGenerate or edit images via Nano Banana Pro using Antigravity OAuth (no API key needed!) OpenClaw Skills integration.
ownercgnl
repositorycgnl/nano-banana-antigravity
languageMarkdown
licenseMIT
topics
securityL1
installopenclaw add @cgnl/nano-banana-antigravity
last updatedFeb 7, 2026

Maintainer

cgnl

cgnl

Maintains nano-banana-antigravity in the OpenClaw Skills directory.

View GitHub profile
File Explorer
6 files
.
scripts
generate_image.py
14.7 KB
generate_whatsapp_hd.sh
2.1 KB
_meta.json
488 B
README.md
2.6 KB
SKILL.md
3.2 KB
SKILL.md

name: nano-banana-antigravity description: Generate or edit images via Nano Banana Pro using Antigravity OAuth (no API key needed!) homepage: https://antigravity.google metadata: {"openclaw":{"emoji":"🍌","requires":{"bins":["uv"]}}}

Nano Banana Antigravity (Gemini 3 Pro Image via OAuth)

Generate images using Nano Banana Pro (Gemini 3 Pro Image) via your existing Google Antigravity OAuth credentials.

No separate API key needed! Uses the same OAuth tokens as your OpenClaw Antigravity provider.

Generate Image

For WhatsApp HD (recommended):

{baseDir}/scripts/generate_whatsapp_hd.sh \
  --prompt "your image description" \
  --filename "output.jpg" \
  --aspect-ratio 16:9 \
  --resolution 4K

Standard PNG output:

uv run {baseDir}/scripts/generate_image.py --prompt "your image description" --filename "output.png"

Generate with Options

{baseDir}/scripts/generate_whatsapp_hd.sh \
  --prompt "a sunset over mountains" \
  --filename "sunset.jpg" \
  --aspect-ratio 16:9 \
  --resolution 4K

What generate_whatsapp_hd.sh does:

  • ✅ Auto-converts PNG → progressive JPEG
  • ✅ Optimizes quality (85-92%) to stay under 6.28MB
  • ✅ WhatsApp HD ready (no compression!)
  • ✅ Warns if image is too large

Edit/Composite Images

uv run {baseDir}/scripts/generate_image.py \
  --prompt "add sunglasses to this person" \
  --filename "edited.png" \
  -i original.png

Multi-image Composition

uv run {baseDir}/scripts/generate_image.py \
  --prompt "combine these into one scene" \
  --filename "composite.png" \
  -i image1.png -i image2.png -i image3.png

Options

  • --prompt, -p (required): Image description or edit instructions
  • --filename, -f (required): Output filename
  • --input-image, -i: Input image(s) for editing (can be repeated)
  • --aspect-ratio, -a: 1:1 (default), 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  • --resolution, -r: 1K, 2K (default), 4K

Authentication

Uses existing OpenClaw Antigravity OAuth credentials. Make sure you're authenticated:

openclaw models auth login --provider google-antigravity

The script looks for credentials in:

  • ~/.openclaw/credentials/google-antigravity.json
  • ~/.config/openclaw/credentials/google-antigravity.json
  • ~/.config/opencode/antigravity-accounts.json

WhatsApp HD Upload Limits

For best WhatsApp HD quality:

  • Use generate_whatsapp_hd.sh instead of generate_image.py
  • Output filename must end in .jpg or .jpeg
  • Images ≤6.28MB will upload without compression
  • Images >6.28MB may be compressed by WhatsApp

Size guidelines:

  • ≤6.28MB → ✅ HD (no compression)
  • 6.29-6.5MB → Slight compression (~5.7MB)
  • 6.5-7.6MB → Moderate compression (~6.2MB)
  • 9MB → ⚠️ Heavy compression

Notes

  • The script prints a MEDIA: line for OpenClaw to auto-attach on supported chat providers.
  • Do not read the image back; report the saved path only.
  • Uses timestamps in filenames for uniqueness: yyyy-mm-dd-hh-mm-ss-name.png
  • Falls back to regular Nano Banana if Nano Banana Pro isn't available yet.
  • Account rotation: Automatically tries all 12 Antigravity accounts on rate limits
README.md

nano-banana-antigravity

🍌 Generate images using Nano Banana Pro (Gemini 3 Pro Image) via your existing Google Antigravity OAuth credentials.

No separate API key needed! Uses the same OAuth tokens as your OpenClaw Antigravity provider.

Features

  • ✅ Uses existing OpenClaw Antigravity OAuth tokens
  • ✅ No separate Gemini API key required
  • ✅ Supports Nano Banana Pro (with fallback to regular Nano Banana)
  • WhatsApp HD ready - auto-converts to progressive JPEG <6.28MB
  • ✅ Multiple aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4, etc.
  • ✅ Multiple resolutions: 1K, 2K, 4K
  • ✅ Image editing and multi-image composition
  • ✅ Automatic account rotation (12 Antigravity accounts)

Prerequisites

  • OpenClaw with google-antigravity-auth plugin enabled
  • Authenticated Antigravity account: openclaw models auth login --provider google-antigravity
  • uv (Python package runner): brew install uv

Usage

Generate Image (WhatsApp HD - Recommended)

./skills/nano-banana-antigravity/scripts/generate_whatsapp_hd.sh \
  --prompt "a sunset over mountains" \
  --filename "sunset.jpg" \
  --aspect-ratio 16:9 \
  --resolution 4K

What it does:

  • Generates 4K image via Nano Banana Pro
  • Auto-converts PNG → progressive JPEG
  • Optimizes quality to stay under 6.28MB
  • WhatsApp HD ready (no compression!)

Generate PNG (Standard)

uv run skills/nano-banana-antigravity/scripts/generate_image.py \
  --prompt "a futuristic city skyline" \
  --filename "city.png" \
  --aspect-ratio 16:9 \
  --resolution 2K

Edit Image

uv run skills/nano-banana-antigravity/scripts/generate_image.py \
  --prompt "add sunglasses to this person" \
  --filename "edited.png" \
  -i original.png

Multi-image Composition

uv run skills/nano-banana-antigravity/scripts/generate_image.py \
  --prompt "combine these into one scene" \
  --filename "composite.png" \
  -i image1.png -i image2.png

Options

OptionShortDescriptionDefault
--prompt-pImage description (required)-
--filename-fOutput filename (required)-
--input-image-iInput image for editing (repeatable)-
--aspect-ratio-aAspect ratio1:1
--resolution-rResolution (1K, 2K, 4K)1K

Supported Aspect Ratios

1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9

How It Works

This skill uses the same CloudCode API that powers Google Antigravity's built-in image generation. It reads your existing OAuth refresh tokens from OpenClaw's auth-profiles and uses them to call the Gemini 3 Pro Image model.

License

MIT

Permissions & Security

Security level L1: Low-risk skills with minimal permissions. Review inputs and outputs before running in production.

Requirements

  • OpenClaw CLI installed and configured.
  • Language: Markdown
  • License: MIT
  • Topics:

FAQ

How do I install nano-banana-antigravity?

Run openclaw add @cgnl/nano-banana-antigravity in your terminal. This installs nano-banana-antigravity into your OpenClaw Skills catalog.

Does this skill run locally or in the cloud?

OpenClaw Skills execute locally by default. Review the SKILL.md and permissions before running any skill.

Where can I verify the source code?

The source repository is available at https://github.com/openclaw/skills/tree/main/skills/cgnl/nano-banana-antigravity. Review commits and README documentation before installing.