跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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。

​
相關