跳轉到主要內容

頻道位置解析

OpenClaw 會將來自聊天頻道分享的位置正規化為:
  • human-readable text appended to the inbound body, and
  • structured fields in the auto-reply context payload.
目前支援:
  • Telegram(位置釘選 + 地點 + 即時位置)
  • WhatsApp(locationMessage + liveLocationMessage)
  • Matrix(m.location 與 geo_uri)

文字格式

位置會以不含括號的友善文字行呈現:
  • PIN:
    • 📍 48.858844, 2.294351 ±12m
  • 已命名地點:
    • 📍 Eiffel Tower — Champ de Mars, Paris (48.858844, 2.294351 ±12m)
  • 即時分享:
    • 🛰 Live location: 48.858844, 2.294351 ±12m
如果頻道包含說明文字/註解,會附加在下一行:

情境欄位

當存在位置時,以下欄位會加入到 ctx 中:
  • LocationLat(number)
  • LocationLon(number)
  • LocationAccuracy(number,公尺;選用)
  • LocationName(string;選用)
  • LocationAddress(string;選用)
  • LocationSource(pin | place | live)
  • LocationIsLive(boolean)

Channel notes

  • Telegram:地點會對應到 LocationName/LocationAddress;即時位置使用 live_period。
  • WhatsApp:locationMessage.comment 與 liveLocationMessage.caption 會作為說明文字行附加。
  • Matrix:geo_uri 會解析為釘選位置;高度會被忽略,且 LocationIsLive 一律為 false。