Configuration
通道位置解析
OpenClaw 會將聊天頻道分享的位置正規化為:
- 附加到傳入本文的簡短座標文字,以及
- 自動回覆情境承載中的結構化欄位。頻道提供的標籤、地址和說明/留言會透過共用的不受信任中繼資料 JSON 區塊轉譯到提示中,而不是內嵌在使用者本文裡。
目前支援:
- Telegram(位置圖釘 + 場所 + 即時位置)
- WhatsApp(locationMessage + liveLocationMessage)
- Matrix(含有
geo_uri的m.location)
文字格式
位置會轉譯為不含括號的友善行:
- 圖釘:
📍 48.858844, 2.294351 ±12m
- 具名地點:
📍 48.858844, 2.294351 ±12m
- 即時分享:
🛰 Live location: 48.858844, 2.294351 ±12m
如果頻道包含標籤、地址或說明/留言,會保留在情境承載中,並以加上圍欄的不受信任 JSON 顯示在提示中:
Location (untrusted metadata):
```json
{
"latitude": 48.858844,
"longitude": 2.294351,
"name": "Eiffel Tower",
"address": "Champ de Mars, Paris",
"caption": "Meet here"
}
```
情境欄位
當存在位置時,這些欄位會加入 ctx:
LocationLat(數字)LocationLon(數字)LocationAccuracy(數字,公尺;選用)LocationName(字串;選用)LocationAddress(字串;選用)LocationSource(pin | place | live)LocationIsLive(布林值)LocationCaption(字串;選用)
提示轉譯器會將 LocationName、LocationAddress 和 LocationCaption 視為不受信任的中繼資料,並透過與其他頻道情境相同的有界 JSON 路徑將它們序列化。
頻道附註
- Telegram:場所會對應到
LocationName/LocationAddress;即時位置使用live_period。 - WhatsApp:
locationMessage.comment和liveLocationMessage.caption會填入LocationCaption。 - Matrix:
geo_uri會剖析為圖釘位置;高度會被忽略,且LocationIsLive一律為 false。