메인 콘텐츠로 건너뛰기

채널 위치 파싱

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