What to build#

1. Civitai provider config in openclaw.json#

{
  "providers": {
    "civitai": {
      "baseUrl": "https://orchestration.civitai.com/v2/consumer",
      "apiKey": { "source": "env", "provider": "default", "id": "CIVITAI_API_KEY" },
      "api": "custom",  // not OpenAI-compatible
      "models": [...]
    }
  }
}

Register 3 default models:

• pony-diffusion-v6-xl (Pony Diffusion V6 XL — best NSFW model on the platform)
• zimage-turbo (Z-Image — fastest, cheapest, good for tests)
• sdxl-base (SDXL 1.0 — good all-rounder, SFW)

Cost data for each model (in Buzz credits):

• Pony: ~5 Buzz/image
• Z-Image: ~2 Buzz/image
• SDXL: ~4 Buzz/image

2. Bridge script: scripts/civitai-gen.sh#

Civitai's orchestration API is NOT OpenAI-compatible (uses custom workflow JSON). Need a shell bridge:

./scripts/civitai-gen.sh \
  --model "pony-diffusion-v6-xl" \
  --prompt "..." \
  --width 1024 \
  --height 1024 \
  --output /tmp/civitai-output.png

The script should:

1. Resolve model name → AIR URN (hardcoded lookup or from config)
2. Build workflow JSON with sdcpp engine
3. POST to orchestration.civitai.com/v2/consumer/workflows?wait=60
4. On timeout (wait=60), poll GET /consumer/workflows/{id} every 5s
5. Download the output image to the specified path
6. Return the path on success, exit 1 on failure

3. Integration with image_generate tool#

The bridge script can be called via exec from any agent session:

exec bash /home/maxime/projects/mission-control/scripts/civitai-gen.sh --model pony-diffusion-v6-xl --prompt "..."

Acceptance criteria#

• Civitai provider config in openclaw.json (3 models)
• scripts/civitai-gen.sh — functional bridge script
• Manual smoke test: generate 1 image via civitai-gen.sh
• Error handling: network failure, auth failure (401), model not found
• Timeout handling: re-poll on wait= expiry
• Docstring at top of script with usage example
• All existing 905+ tests pass

Blocked on#

t-3454 — Maxime needs to sign up and provide API key first

Reference#

Full design: projects/image-gen/civitai-setup-spec.md Civitai API docs: https://developer.civitai.com/orchestration/recipes/flux1