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-путь, который используется для другого контекста канала.

​
Исходящие полезные нагрузки

Инструмент сообщений и Plugin SDK используют одну и ту же структуру 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.

​
Связанные материалы