ClawHub

Nanobanana Pro

Nano Banana Pro with auto model fallback — generate/edit images via Gemini Image API. Run via: uv run {baseDir}/scripts/generate_image.py --prompt 'desc' --filename 'out.png' [--resolution 1K|2K|4K] [-i input.png]. Supports text-to-image + image-to-image (up to 14); 1K/2K/4K. Fallback chain: gemini-2.5-flash-image → gemini-2.0-flash-exp. MUST use uv run, not python3.

Audits

Pass
ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install nanobanana-pro-fallback

Nano Banana Pro with Fallback

Use the bundled script to generate or edit images. Automatically falls back through multiple Gemini models if one fails.

⚠️ IMPORTANT: MUST use uv run or the generate wrapper. Do NOT use python3 directly — dependencies won't be available.

Generate (option A: wrapper script)

{baseDir}/scripts/generate --prompt "your image description" --filename "output.png" --resolution 1K

Generate (option B: uv run)

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

Edit (single image)

uv run {baseDir}/scripts/generate_image.py --prompt "edit instructions" --filename "output.png" -i "/path/in.png" --resolution 2K

Multi-image composition (up to 14 images)

uv run {baseDir}/scripts/generate_image.py --prompt "combine these into one scene" --filename "output.png" -i img1.png -i img2.png -i img3.png

API key

  • GEMINI_API_KEY env var
  • Or set skills."nanobanana-pro-fallback".apiKey / skills."nanobanana-pro-fallback".env.GEMINI_API_KEY in ~/.openclaw/openclaw.json

Notes

  • Resolutions: 1K (default), 2K, 4K.
  • Models tried in order: gemini-2.5-flash-image → gemini-2.0-flash-exp-image-generation (configurable via NANOBANANA_FALLBACK_MODELS env var).
  • Use timestamps in filenames: yyyy-mm-dd-hh-mm-ss-name.png.
  • 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.