Channel location parsing

기준일: 2026-07-26
공식 기준: Channel location parsing

Channel location parsing 문서는 OpenClaw 공식 문서(channels/location)를 한국어로 정리한 가이드입니다. Channel location parsing and portable outbound location payloads 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Channel location parsing and portable outbound location payloads

한국어 가이드 범위: channels/location 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Text formatting
• Context fields
• Outbound payloads
• Channel notes
• 관련 문서

상세 내용

본문

OpenClaw normalizes shared locations from chat channels into:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• 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.
• 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:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• 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

Location (untrusted metadata):

Context fields

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

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

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

Outbound payloads

The message tool and Plugin SDK use the same NormalizedLocation shape for portable outbound locations. A coordinate-only payload represents a pin. Channels with native venue support may map name plus address to a venue card.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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.

관련 문서

주요 항목:

• Location command (nodes)
• Camera capture
• Media understanding

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/channels/location
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

Location (untrusted metadata):

관련 링크

• 공식 원문: channels/location
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.