--- name: glm-image description: Generate images using GLM-Image API. Use when the user wants to generate, create, or draw an image from a text prompt. Triggers on requests like "generate an image of...", "create a picture of...", "draw...", or any image generation request. --- # GLM-Image Generator Generate images from text prompts using the GLM-Image API. > **Attribution:** Based on [glm-image](https://github.com/ViffyGwaanl/glm-image) by ViffyGwaanl (MIT License). ## Setup This skill supports two providers. **You only need one.** ### Option A — GLM (BigModel / Zhipu AI) Requires `GLM_API_KEY` from https://open.bigmodel.cn → Console → API Keys ```bash export GLM_API_KEY=your-key # or add to ~/.openclaw/config.json: { "api_key": "your-key" } # or add GLM_API_KEY=your-key to .env ``` ### Option B — OpenRouter Requires `OPENROUTER_API_KEY` from https://openrouter.ai → Keys ```bash export OPENROUTER_API_KEY=your-key # or add to ~/.openclaw/config.json: { "openrouter_api_key": "your-key" } # or add OPENROUTER_API_KEY=your-key to .env ``` Default OpenRouter model: `google/gemini-3-pro-image-preview`. Other options: `openai/gpt-5-image-mini`, `openai/gpt-5-image`, `google/gemini-2.5-flash-image-preview`. See full list at https://openrouter.ai/collections/image-models **Auto-detection:** if both keys are present, GLM is used. Override with `--provider openrouter`. ## Usage When a user requests image generation: **Step 0 — Verify at least one API key is configured** Run: ```bash python3 -c " import os, json, pathlib glm = bool(os.environ.get('GLM_API_KEY')) orouter = bool(os.environ.get('OPENROUTER_API_KEY')) if not glm and not orouter: for p in ['~/.openclaw/config.json', '~/.claude/config.json']: try: d = json.loads(pathlib.Path(p).expanduser().read_text()) if d.get('api_key'): glm = True if d.get('openrouter_api_key'): orouter = True except: pass keys = [] if glm: keys.append('GLM_API_KEY') if orouter: keys.append('OPENROUTER_API_KEY') print('FOUND: ' + ', '.join(keys) if keys else 'KEY_MISSING') " ``` If output is `KEY_MISSING`, tell the user: > "No API key is configured. This skill supports two providers — you only need one: > > **Option A — GLM (BigModel):** Get key at https://open.bigmodel.cn → Console → API Keys, then: > ``` > export GLM_API_KEY=your-key > ``` > > **Option B — OpenRouter:** Get key at https://openrouter.ai → Keys, then: > ``` > export OPENROUTER_API_KEY=your-key > ``` > > For either option you can also add the key to `~/.openclaw/config.json`: > ```json > { "api_key": "glm-key" } > { "openrouter_api_key": "openrouter-key" } > ```" Do not proceed until the user confirms a key is set. **Step 1 — Ask for language (MANDATORY, no exceptions)** Before running anything, ask: > "What language is your prompt in? Please choose: zh (Chinese), en (English), ja (Japanese), ko (Korean), fr (French), de (German), es (Spanish)." Do NOT infer language from the user's message language or any other signal. Do NOT default to any language. Do NOT proceed until the user explicitly states a language code. **Step 2 — Run the generation script** ```bash python3 scripts/generate.py "" --language


```

`--language` is required. The script will error if omitted.

Other defaults:

- Size: 1088x1920 (portrait HD)
- Output: `output/` folder
- No watermark

**Step 3 — Return the result**

Display the markdown image link and local file path.

## Generate Image

```bash
python3 scripts/generate.py "" --language 
```

Provider is auto-detected from available keys. Override explicitly:

```bash
# Force OpenRouter with a specific model
python3 scripts/generate.py "" --language en --provider openrouter --model google/gemini-2.5-flash-image-preview

# Force GLM
python3 scripts/generate.py "" --language zh --provider glm
```

### Options

- `--language`: **(Required)** Prompt language. Must be explicitly provided by the user. Supported: `zh` (Chinese), `en` (English), `ja` (Japanese), `ko` (Korean), `fr` (French), `de` (German), `es` (Spanish)
- `--provider`: `glm` or `openrouter`. Auto-detected if omitted (GLM preferred when both keys present)
- `--model`: OpenRouter model slug (default: `google/gemini-3-pro-image-preview`). Ignored for GLM. See https://openrouter.ai/collections/image-models
- `--size`: Image dimensions, GLM only (default: 1088x1920). Valid range: 512-2048px, multiples of 32
- `--output`: Output directory (default: output/)
- `--quality`: Image quality, GLM only — "hd" or "standard" (default: hd)
- `--watermark`: Enable watermark, GLM only

### Language Selection Rules

- **Always ask explicitly.** Never guess from the user's message language.
- **Never default.** If the user does not specify, ask again.
- **Record as-typed.** Pass exactly what the user said (e.g., `zh`, `en`) — do not normalize.
- Reason: GLM is a Chinese-native model; prompt language significantly affects output quality and style.

### Available Sizes

- 1088x1920 (default, portrait HD)
- 1920x1088 (landscape HD)
- 1280x1280 (square)
- 1568x1056, 1056x1568
- 1472x1088, 1088x1472
- 1728x960, 960x1728

## Output Format

After successful generation, display:

1. Local file path: `output/_.png`
2. Markdown image link: `![]()`

## Agent Owner

This skill is executed by the main OpenClaw agent session. The `generate.py` script
runs as a shell command via the exec tool. No sub-agents are spawned.

## Success Criteria

Image generation succeeds when:
1. Script exits with code 0
2. Image file saved to output/ directory
3. Markdown image link displayed to user

Failure conditions: invalid API key, unsupported size, network timeout (120s), API quota exceeded.

## Edge Cases

- Invalid size: must be 512-2048px in multiples of 32 — script will fail with API error
- Long prompts: prompt truncated to 30 chars in filename (full prompt used for generation)
- Network timeout: 120s API timeout, 60s download timeout — retry once if timeout
- Missing API key: script exits with clear error message listing search locations
- Chinese characters in prompt: supported, filename sanitized automatically

## Requirements

- GLM API key configured (see Setup section above)
- Python 3 with `requests` package (`pip install requests`)

GLM Image Generator

Description

Latest Changes

Install GLM Image Generator with One Click