| name | draw-image |
| description | Generate an image from a text prompt using an OpenAI-compatible image generation API (gpt-image-1-mini or compatible). The image is uploaded to the gofile.io public file sharing service and ONLY the public download page URL is returned. Trigger when user asks to draw, paint, generate, or create an image. |
| metadata | {"openclaw":{"emoji":"🎨","install":[{"id":"python-brew","kind":"brew","formula":"python","bins":["python3"],"label":"Install Python (brew)"}]}} |
Draw Image
Generate images via an OpenAI-compatible images/generations endpoint. The script has a built-in API base and key, so no extra configuration is needed.
Quick Start
Generate an image from a text prompt:
python3 C:\Users\IDD\.openclaw\workspace\skills\draw-image\scripts\draw.py --prompt "A futuristic cityscape at sunset with flying cars"
Parameters
All parameters are optional except --prompt:
python3 C:\Users\IDD\.openclaw\workspace\skills\draw-image\scripts\draw.py \
--prompt "A cute cat wearing a spacesuit" \
--size 1024x1024 \
--model gpt-image-1-mini \
--quality low \
--n 1
--prompt (string, required): Text description of the image to generate.
--size (string, optional): Image dimensions. Default: 1024x1024. Common values: 256x256, 512x512, 1024x1024, 1792x1024, 1024x1792.
--model (string, optional): Image generation model. Default: gpt-image-1-mini.
--quality (string, optional): Image quality: low , medium,high. Default: low.
--n (integer, optional): Number of images to generate. Default: 1.
--out-dir (string, optional): Directory to save images. Default: <projectRoot>/uploads/generated_images/.
--api-base (string, optional): Override the API base URL.
--api-key (string, optional): Override the API key.
Stdin JSON Mode
Alternatively, pass parameters as JSON on stdin:
echo '{"prompt": "A serene mountain landscape at dawn"}' | python3 C:\Users\IDD\.openclaw\workspace\skills\draw-image\scripts\draw.py --stdin
Environment Variable Overrides
DRAW_IMAGE_API_BASE: Override the API base URL.
DRAW_IMAGE_API_KEY: Override the API key.
Output
The image is generated, uploaded to gofile.io, and ONLY the public download page URL is returned.
The script prints a JSON object to stdout:
ok (bool): Whether the generation and upload succeeded.
download_page (string): The public gofile.io download page URL of the generated image. Only this URL is returned as the result. Open this URL in a browser to download the generated image.
note (string): A short hint explaining that download_page is used to download the generated image.
error (string): Error message on failure.
Example success output:
{
"ok": true,
"download_page": "https://gofile.io/d/WcWZKt",
"note": "Use this URL to download the generated image."
}