Channel location parsing

OpenClaw normalizes shared locations from chat channels into:

• 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:

• Telegram (location pins + venues + live locations)
• WhatsApp (locationMessage + liveLocationMessage)
• Matrix (
  text

  Copy

  m.location
  with
  text

  Copy

  geo_uri
  )

Text formatting

Locations are rendered as friendly lines without brackets:

• Pin:
  • text

    Copy

    📍 48.858844, 2.294351 ±12m
• Named place:
  • text

    Copy

    📍 48.858844, 2.294351 ±12m
• Live share:
  • text

    Copy

    🛰 Live location: 48.858844, 2.294351 ±12m

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
Copy
Location (untrusted metadata):
```json
{
  "latitude": 48.858844,
  "longitude": 2.294351,
  "name": "Eiffel Tower",
  "address": "Champ de Mars, Paris",
  "caption": "Meet here"
}
```

Context fields

When a location is present, these fields are added to

:

• text

  Copy

  LocationLat
  (number)
• text

  Copy

  LocationLon
  (number)
• text

  Copy

  LocationAccuracy
  (number, meters; optional)
• text

  Copy

  LocationName
  (string; optional)
• text

  Copy

  LocationAddress
  (string; optional)
• text

  Copy

  LocationSource
  (
  text

  Copy

  pin | place | live
  )
• text

  Copy

  LocationIsLive
  (boolean)
• text

  Copy

  LocationCaption
  (string; optional)

The prompt renderer treats

, , and as untrusted metadata and serializes them through the same bounded JSON path used for other channel context.

Channel notes

• Telegram: venues map to
  text

  Copy

  LocationName/LocationAddress
  ; live locations use
  text

  Copy

  live_period
  .
• WhatsApp:
  text

  Copy

  locationMessage.comment
  and
  text

  Copy

  liveLocationMessage.caption
  populate
  text

  Copy

  LocationCaption
  .
• Matrix:
  text

  Copy

  geo_uri
  is parsed as a pin location; altitude is ignored and
  text

  Copy

  LocationIsLive
  is always false.

Related

• Location command (nodes)
• Camera capture
• Media understanding