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

# 渠道位置解析

# 渠道位置解析

OpenClaw 将聊天渠道中分享的位置标准化为：

* 附加到入站消息体的可读文本，以及
* 自动回复上下文负载中的结构化字段。

目前支持：

* **Telegram**（位置图钉 + 地点 + 实时位置）
* **WhatsApp**（locationMessage + liveLocationMessage）
* **Matrix**（`m.location` 配合 `geo_uri`）

## 文本格式

位置以友好的行格式呈现，不带括号：

* 图钉：
  * `📍 48.858844, 2.294351 ±12m`
* 命名地点：
  * `📍 Eiffel Tower — Champ de Mars, Paris (48.858844, 2.294351 ±12m)`
* 实时分享：
  * `🛰 Live location: 48.858844, 2.294351 ±12m`

如果渠道包含标题/评论，会附加在下一行：

```
📍 48.858844, 2.294351 ±12m
Meet here
```

## 上下文字段

当存在位置信息时，以下字段会被添加到 `ctx` 中：

* `LocationLat`（数字）
* `LocationLon`（数字）
* `LocationAccuracy`（数字，米；可选）
* `LocationName`（字符串；可选）
* `LocationAddress`（字符串；可选）
* `LocationSource`（`pin | place | live`）
* `LocationIsLive`（布尔值）

## 渠道说明

* **Telegram**：地点映射到 `LocationName/LocationAddress`；实时位置使用 `live_period`。
* **WhatsApp**：`locationMessage.comment` 和 `liveLocationMessage.caption` 作为标题行附加。
* **Matrix**：`geo_uri` 解析为图钉位置；忽略海拔高度，`LocationIsLive` 始终为 false。