Skip to main content
OpenClaw нормалізує поширені місцезнаходження з каналів чату в:
  • стислий текст координат, доданий до вхідного тіла повідомлення, і
  • структуровані поля в контекстному навантаженні автовідповіді. Надані каналом мітки, адреси та підписи/коментарі відтворюються в запиті через спільний блок JSON із ненадійними метаданими, а не безпосередньо в тілі повідомлення користувача.
Наразі підтримуються:
  • LINE (повідомлення про місцезнаходження із назвою/адресою)
  • Matrix (m.location з geo_uri)
  • Telegram (позначки місцезнаходження + місця + місцезнаходження в реальному часі)
  • WhatsApp (locationMessage + liveLocationMessage)

​
Форматування тексту

Місцезнаходження відтворюються як зручні для читання рядки без дужок. Координати містять шість знаків після коми; точність округлюється до цілих метрів:
  • Позначка:
    • 📍 48.858844, 2.294351 ±12m
  • Іменоване місце (у тому самому рядку; назва й адреса надходять лише до блоку метаданих):
    • 📍 48.858844, 2.294351 ±12m
  • Поширення в реальному часі:
    • 🛰 Live location: 48.858844, 2.294351 ±12m
Якщо канал містить мітку, адресу або підпис/коментар, вони зберігаються в контекстному навантаженні й з’являються в запиті як відокремлений ненадійний JSON (відсутні поля пропускаються):

​
Поля контексту

За наявності місцезнаходження до ctx додаються такі поля:
  • LocationLat (число)
  • LocationLon (число)
  • LocationAccuracy (число, метри; необов’язково)
  • LocationName (рядок; необов’язково)
  • LocationAddress (рядок; необов’язково)
  • LocationSource (pin | place | live)
  • LocationIsLive (логічне значення)
  • LocationCaption (рядок; необов’язково)
Якщо канал не задає джерело явно, OpenClaw визначає його автоматично: поширення в реальному часі стають live, місцезнаходження з назвою або адресою — place, а решта — pin. Засіб відтворення запитів розглядає LocationName, LocationAddress і LocationCaption як ненадійні метадані та серіалізує їх через той самий обмежений шлях JSON, що використовується для іншого контексту каналу.

​
Вихідні навантаження

Інструмент повідомлень і SDK Plugin використовують однакову структуру NormalizedLocation для переносних вихідних місцезнаходжень. Навантаження лише з координатами представляє позначку. Канали з нативною підтримкою місць можуть зіставляти name разом із address із карткою місця. Наразі Telegram надає це через message(action="send"). Перша реалізація навмисно є автономною: навантаження місцезнаходження не можна поєднувати з текстом або медіафайлами, а неповні пари даних про місце спричиняють помилку замість непомітного відкидання назви чи адреси. Непідтримувані канали не оголошують параметр місцезнаходження.

​
Примітки щодо каналів

  • LINE: поля title/address повідомлення про місцезнаходження зіставляються з LocationName/LocationAddress; місцезнаходження в реальному часі не підтримуються.
  • Matrix: geo_uri розбирається як позначка місцезнаходження; параметр u (невизначеність) зіставляється з LocationAccuracy, тіло події заповнює LocationCaption, висота ігнорується, а LocationIsLive завжди має значення false.
  • Telegram: місця зіставляються з LocationName/LocationAddress; місцезнаходження в реальному часі виявляються через live_period.
  • WhatsApp: locationMessage.comment і liveLocationMessage.caption заповнюють LocationCaption.

​
Пов’язані матеріали