跳转到主要内容

渠道位置解析

OpenClaw 将聊天渠道中分享的位置标准化为:
  • 附加到入站消息体的可读文本,以及
  • 自动回复上下文负载中的结构化字段。
目前支持:
  • Telegram(位置图钉 + 地点 + 实时位置)
  • WhatsApp(locationMessage + liveLocationMessage)
  • Matrixm.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(字符串;可选)
  • LocationSourcepin | place | live
  • LocationIsLive(布尔值)

渠道说明

  • Telegram:地点映射到 LocationName/LocationAddress;实时位置使用 live_period
  • WhatsApplocationMessage.commentliveLocationMessage.caption 作为标题行附加。
  • Matrixgeo_uri 解析为图钉位置;忽略海拔高度,LocationIsLive 始终为 false。