> ## 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 는 채팅 채널에서 공유된 위치를 다음과 같이 정규화합니다:

* 인바운드 본문에 추가되는 사람이 읽기 쉬운 텍스트, 그리고
* 자동 응답 컨텍스트 페이로드의 구조화된 필드.

현재 지원됨:

* **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 입니다.