Sudocode Nano Banana2#

Generate images from text prompts or edit a local image with a prompt through the remote Sudocode API.

Initialize environment on first run#

Before the first real use, check whether the required variables exist:

bash

uv run python <skill_dir>/scripts/init_env.py --check-only

If the check reports missing variables, tell the user to first register at https://sudocode.us and apply for an API key, then run:

bash

uv run python <skill_dir>/scripts/init_env.py

The initializer will prompt for values and persist them to ~/.openclaw/.env.

Use the bundled script#

Run:

bash

uv run python <skill_dir>/scripts/sudocode_nano_banana2.py --prompt "..." [--input_image path] [--output path]

Inputs:

• --prompt: required
• --input_image: optional local image path for image-to-image editing
• --output: optional output path, defaults to output.png

Environment:

• SUDOCODE_IMAGE_API_KEY: required API key; if missing, direct the user to register at https://sudocode.us and apply for an API key first
• SUDOCODE_BASE_URL: optional API base URL for the remote Sudocode service, defaults to https://sudocode.run

Behavior notes:

• This skill is an API client, not a local inference model
• It sends prompts and optional input images to the configured Sudocode endpoint
• It stores credentials in ~/.openclaw/.env only when the initializer is used
• It writes generated image files and per-run logs to local disk near the chosen output path

The initializer writes these values into ~/.openclaw/.env so future sessions can reuse them.

Remote API and model naming#

This skill is named sudocode-nano-banana2 because it packages Sudocode's Nano Banana 2 image capability for OpenClaw.

The bundled script currently calls the upstream model identifier gemini-3.1-flash-image-preview exposed by the configured Sudocode-compatible endpoint. The skill name and upstream model identifier are intentionally different: one is the packaged skill name, the other is the current backend route used by the service.

If requests is missing, install it with:

bash

uv pip install requests

Packaging and portability#

This skill is structured as a standard skill package:

• SKILL.md: trigger metadata and operating instructions
• scripts/init_env.py: first-run environment bootstrap helper
• scripts/sudocode_nano_banana2.py: bundled runtime script

Do not include generated images, logs, or other local run artifacts in the distributable package.

Delivering generated images#

When using this skill inside OpenClaw, send the generated file with the message tool so the user can actually receive the image.

Use:

text

message(action="send", filePath="/absolute/path/to/output.png")

Then reply NO_REPLY to avoid duplicate text.

Do not rely on reading the image file or pasting a local path into chat.

Error handling#

If the script exits with code 2, relay this message to the user:

text

❌ 额度不足或请求过于频繁！
👉 请前往 https://sudocode.us 登录并充值后重试。

For other failures, show the script output directly.