跳转到主要内容

渠道位置解析

OpenClaw 将聊天渠道共享的位置规范化为:
  • 追加到入站正文的人类可读文本,以及
  • 自动回复上下文 payload 中的结构化字段。
当前支持:
  • Telegram(位置钉点 + 场所 + 实时位置)
  • WhatsApp(locationMessage + liveLocationMessage)
  • Matrix(带 geo_urim.location

Text formatting

位置会以友好的行展示(不含方括号):
  • 钉点:
    • 📍 48.858844, 2.294351 ±12m
  • 命名地点:
    • 📍 Eiffel Tower — Champ de Mars, Paris (48.858844, 2.294351 ±12m)
  • 实时共享:
    • 🛰 Live location: 48.858844, 2.294351 ±12m
如果渠道包含 caption/comment,会在下一行追加:
📍 48.858844, 2.294351 ±12m
Meet here

Context fields

当位置存在时,这些字段会加入 ctx
  • LocationLat(number)
  • LocationLon(number)
  • LocationAccuracy(number,米;可选)
  • LocationName(string;可选)
  • LocationAddress(string;可选)
  • LocationSourcepin | place | live
  • LocationIsLive (boolean)

Channel notes

  • Telegram:venue 映射到 LocationName/LocationAddress;实时位置使用 live_period
  • WhatsApp: locationMessage.comment and liveLocationMessage.caption are appended as the caption line.
  • Matrixgeo_uri 解析为钉点位置;忽略海拔,且 LocationIsLive 总为 false。