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

# 頻道位置解析

# 頻道位置解析

OpenClaw 會將來自聊天頻道分享的位置正規化為：

* human-readable text appended to the inbound body, and
* structured fields in the auto-reply context payload.

目前支援：

* **Telegram**（位置釘選 + 地點 + 即時位置）
* **WhatsApp**（locationMessage + liveLocationMessage）
* **Matrix**（`m.location` 與 `geo_uri`）

## 文字格式

位置會以不含括號的友善文字行呈現：

* PIN：
  * `📍 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`（number）
* `LocationLon`（number）
* `LocationAccuracy`（number，公尺；選用）
* `LocationName`（string；選用）
* `LocationAddress`（string；選用）
* `LocationSource`（`pin | place | live`）
* `LocationIsLive`（boolean）

## Channel notes

* **Telegram**：地點會對應到 `LocationName/LocationAddress`；即時位置使用 `live_period`。
* **WhatsApp**：`locationMessage.comment` 與 `liveLocationMessage.caption` 會作為說明文字行附加。
* **Matrix**：`geo_uri` 會解析為釘選位置；高度會被忽略，且 `LocationIsLive` 一律為 false。