diff --git a/docs/QWEN_IMAGE_21.md b/docs/QWEN_IMAGE_21.md
index 8640eb7..bf26b66 100644
--- a/docs/QWEN_IMAGE_21.md
+++ b/docs/QWEN_IMAGE_21.md
@@ -93,6 +93,19 @@ openclaw config unset agents.defaults.imageModel
 Die leere Fallbackliste verhindert, dass OpenClaw bei einem lokalen Fehler
 unbemerkt auf `openai/gpt-image-2` ausweicht.
 
+OpenClaw überträgt Referenzbilder an `/v1/images/edits` als
+OpenAI-kompatibles Multipart-Formular mit dem Feld `image[]`. Der Router
+akzeptiert dort ein bis vier Referenzbilder und normalisiert numerische
+Formularwerte wie `n` und `steps`. Der ältere JSON-/Base64-Weg bleibt für
+bestehende Clients erhalten.
+
+Beim ersten Wechsel von FLUX auf Qwen funktionierten Referenzbilder deshalb
+nicht: Der neue Qwen-Pfad verstand zunächst nur den älteren JSON-/Base64-Weg.
+Zusätzlich war anfangs `agents.defaults.imageModel` gesetzt, obwohl
+OpenClaws `image_generate` den Eintrag unter
+`agents.defaults.mediaModels.image` verwendet. Das waren Lücken der neuen
+Qwen-Integration. Der zuvor produktive FLUX-Pfad war davon nicht betroffen.
+
 ## Produktionsvalidierung vom 21. September 2026
 
 Beide öffentlichen Routerpfade wurden auf Athena mit dem produktiven Stack
@@ -115,6 +128,13 @@ OpenClaw-`agent exec`-Lauf geprüft. OpenClaw rief
 `openai/Qwen-Image-2.1-int8` einmal auf; Athena erzeugte das PNG und stellte
 Medium sowie Qwen3-TTS nach 72,5 Sekunden wieder gesund her.
 
+Auch die Referenzbildbearbeitung wurde anschließend über das echte
+OpenClaw-Werkzeug `image_generate` geprüft. OpenClaw übergab ein Referenzbild
+als `image[]`; der Router erzeugte mit `Qwen-Image-2.1-int8` ein gültiges
+PNG mit 1024×1024 Pixeln und meldete im Sidecar `mode: image-edit` sowie
+`reference_images: 1`. Medium und Qwen3-TTS liefen nach dem Auftrag wieder
+gesund, der Bildworker wurde erwartungsgemäß gestoppt.
+
 ## FLUX-Rückfallpfad
 
 FLUX verwendet weiterhin das Image `mike-ai/image-worker:local`, die