From efb8296d260189c110ef52ebf86ffe6540e8c3ac Mon Sep 17 00:00:00 2001
From: "openclaw-docs-sync[bot]"
 <openclaw-docs-sync[bot]@users.noreply.github.com>
Date: Thu, 23 Apr 2026 17:05:49 +0000
Subject: [PATCH] chore(sync): mirror docs from
 openclaw/openclaw@fb47c1d6bf0b95c788f647a05faec934d08abb19

---
 .openclaw-sync/source.json |  4 ++--
 docs/channels/location.md  | 27 +++++++++++++++++++--------
 2 files changed, 21 insertions(+), 10 deletions(-)

diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 9a8f7eb22..aed61d9cc 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "79d8ce730a8e1bff4302d77a9e1f0f474ddee108",
-  "syncedAt": "2026-04-23T16:54:31.079Z"
+  "sha": "fb47c1d6bf0b95c788f647a05faec934d08abb19",
+  "syncedAt": "2026-04-23T17:04:12.975Z"
 }
diff --git a/docs/channels/location.md b/docs/channels/location.md
index ddfdfd5cd..87297785f 100644
--- a/docs/channels/location.md
+++ b/docs/channels/location.md
@@ -10,8 +10,8 @@ title: "Channel Location Parsing"
 
 OpenClaw normalizes shared locations from chat channels into:
 
-- human-readable text appended to the inbound body, and
-- structured fields in the auto-reply context payload.
+- terse coordinate text appended to the inbound body, and
+- structured fields in the auto-reply context payload. Channel-provided labels, addresses, and captions/comments are rendered into the prompt by the shared untrusted metadata JSON block, not inline in the user body.
 
 Currently supported:
 
@@ -26,16 +26,24 @@ Locations are rendered as friendly lines without brackets:
 - Pin:
   - `📍 48.858844, 2.294351 ±12m`
 - Named place:
-  - `📍 Eiffel Tower — Champ de Mars, Paris (48.858844, 2.294351 ±12m)`
+  - `📍 48.858844, 2.294351 ±12m`
 - Live share:
   - `🛰 Live location: 48.858844, 2.294351 ±12m`
 
-If the channel includes a caption/comment, it is appended on the next line:
+If the channel includes a label, address, or caption/comment, it is preserved in the context payload and appears in the prompt as fenced untrusted JSON:
 
+````text
+Location (untrusted metadata):
+```json
+{
+  "latitude": 48.858844,
+  "longitude": 2.294351,
+  "name": "Eiffel Tower",
+  "address": "Champ de Mars, Paris",
+  "caption": "Meet here"
+}
 ```
-📍 48.858844, 2.294351 ±12m
-Meet here
-```
+````
 
 ## Context fields
 
@@ -48,9 +56,12 @@ When a location is present, these fields are added to `ctx`:
 - `LocationAddress` (string; optional)
 - `LocationSource` (`pin | place | live`)
 - `LocationIsLive` (boolean)
+- `LocationCaption` (string; optional)
+
+The prompt renderer treats `LocationName`, `LocationAddress`, and `LocationCaption` as untrusted metadata and serializes them through the same bounded JSON path used for other channel context.
 
 ## Channel notes
 
 - **Telegram**: venues map to `LocationName/LocationAddress`; live locations use `live_period`.
-- **WhatsApp**: `locationMessage.comment` and `liveLocationMessage.caption` are appended as the caption line.
+- **WhatsApp**: `locationMessage.comment` and `liveLocationMessage.caption` populate `LocationCaption`.
 - **Matrix**: `geo_uri` is parsed as a pin location; altitude is ignored and `LocationIsLive` is always false.