diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index eb2d4d0b6..b291e74cf 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "6b3e4b88d687b2ab30fc6026f3ccffd6487d3faf",
-  "syncedAt": "2026-04-25T17:06:28.288Z"
+  "sha": "0d274ef6c284ee64bb7a43ebbc527eec3a299e31",
+  "syncedAt": "2026-04-25T17:09:59.439Z"
 }
diff --git a/docs/web/control-ui.md b/docs/web/control-ui.md
index 4e7ec96bc..8c98a6980 100644
--- a/docs/web/control-ui.md
+++ b/docs/web/control-ui.md
@@ -83,6 +83,12 @@ synced to other devices or persisted server-side beyond the normal transcript
 authorship metadata on messages you actually send. Clearing site data or
 switching browsers resets it to empty.
 
+The same browser-local pattern applies to the assistant avatar override.
+Uploaded assistant avatars overlay the gateway-resolved identity on the local
+browser only and never round-trip through `config.patch`. The shared
+`ui.assistant.avatar` config field is still available for non-UI clients
+writing the field directly (such as scripted gateways or custom dashboards).
+
 ## Runtime config endpoint
 
 The Control UI fetches its runtime settings from