> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

* **LINE** (location messages with title/address)
* **Matrix** (`m.location` with `geo_uri`)
* **Telegram** (location pins + venues + live locations)
* **WhatsApp** (`locationMessage` + `liveLocationMessage`)

## Text formatting

Locations are rendered as friendly lines without brackets. Coordinates use six decimal places; accuracy is rounded to whole meters:

* Pin:
  * `📍 48.858844, 2.294351 ±12m`
* Named place (same line; the name/address go to the metadata block only):
  * `📍 48.858844, 2.294351 ±12m`
* Live share:
  * `🛰 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 (fields are omitted when absent):

````text theme={"theme":{"light":"min-light","dark":"min-dark"}}
Location (untrusted metadata):
```json
{
  "latitude": 48.858844,
  "longitude": 2.294351,
  "accuracy_m": 12,
  "source": "place",
  "name": "Eiffel Tower",
  "address": "Champ de Mars, Paris",
  "caption": "Meet here"
}
```
````

## Context fields

When a location is present, these fields are added to `ctx`:

* `LocationLat` (number)
* `LocationLon` (number)
* `LocationAccuracy` (number, meters; optional)
* `LocationName` (string; optional)
* `LocationAddress` (string; optional)
* `LocationSource` (`pin | place | live`)
* `LocationIsLive` (boolean)
* `LocationCaption` (string; optional)

When the channel does not set an explicit source, OpenClaw infers it: live shares become `live`, locations with a name or address become `place`, everything else is `pin`.

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

* **LINE**: location message `title`/`address` map to `LocationName`/`LocationAddress`; no live locations.
* **Matrix**: `geo_uri` is parsed as a pin location; the `u` (uncertainty) parameter maps to `LocationAccuracy`, the event body populates `LocationCaption`, altitude is ignored, and `LocationIsLive` is always false.
* **Telegram**: venues map to `LocationName`/`LocationAddress`; live locations are detected via `live_period`.
* **WhatsApp**: `locationMessage.comment` and `liveLocationMessage.caption` populate `LocationCaption`.

## Related

* [Location command (nodes)](/nodes/location-command)
* [Camera capture](/nodes/camera)
* [Media understanding](/nodes/media-understanding)