Nano Banana Pro (Gemini 3 Pro Image)
Use the bundled script to generate or edit images.
Generate
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."nano-banana-pro".apiKey / skills."nano-banana-pro".env.GEMINI_API_KEY in ~/.openclaw/openclaw.json
Specific aspect ratio (optional)
uv run {baseDir}/scripts/generate_image.py --prompt "portrait photo" --filename "output.png" --aspect-ratio 9:16
Notes
- Resolutions:
1K (default), 2K, 4K.
- Aspect ratios:
1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9. Without --aspect-ratio / -a, the model picks freely - use this flag for avatars, profile pics, or consistent batch generation.
- 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.
1---
2name: nano-banana-pro
3description: Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro).
4homepage: https://ai.google.dev/
5metadata:
6 {
7 "openclaw":
8 {
9 "emoji": "🍌",
10 "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"] },
11 "primaryEnv": "GEMINI_API_KEY",
12 "install":
13 [
14 {
15 "id": "uv-brew",
16 "kind": "brew",
17 "formula": "uv",
18 "bins": ["uv"],
19 "label": "Install uv (brew)",
20 },
21 ],
22 },
23 }
24---
25
26# Nano Banana Pro (Gemini 3 Pro Image)
27
28Use the bundled script to generate or edit images.
29
30Generate
31
32```bash
33uv run {baseDir}/scripts/generate_image.py --prompt "your image description" --filename "output.png" --resolution 1K
34```
35
36Edit (single image)
37
38```bash
39uv run {baseDir}/scripts/generate_image.py --prompt "edit instructions" --filename "output.png" -i "/path/in.png" --resolution 2K
40```
41
42Multi-image composition (up to 14 images)
43
44```bash
45uv run {baseDir}/scripts/generate_image.py --prompt "combine these into one scene" --filename "output.png" -i img1.png -i img2.png -i img3.png
46```
47
48API key
49
50- `GEMINI_API_KEY` env var
51- Or set `skills."nano-banana-pro".apiKey` / `skills."nano-banana-pro".env.GEMINI_API_KEY` in `~/.openclaw/openclaw.json`
52
53Specific aspect ratio (optional)
54
55```bash
56uv run {baseDir}/scripts/generate_image.py --prompt "portrait photo" --filename "output.png" --aspect-ratio 9:16
57```
58
59Notes
60
61- Resolutions: `1K` (default), `2K`, `4K`.
62- Aspect ratios: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`. Without `--aspect-ratio` / `-a`, the model picks freely - use this flag for avatars, profile pics, or consistent batch generation.
63- Use timestamps in filenames: `yyyy-mm-dd-hh-mm-ss-name.png`.
64- The script prints a `MEDIA:` line for OpenClaw to auto-attach on supported chat providers.
65- Do not read the image back; report the saved path only.