64 lines
1.8 KiB
Markdown
64 lines
1.8 KiB
Markdown
---
|
||
read_when:
|
||
- 添加或修改渠道位置解析
|
||
- 在智能体提示或工具中使用位置上下文字段
|
||
summary: 入站渠道位置解析（Telegram + WhatsApp）及上下文字段
|
||
title: 渠道位置解析
|
||
x-i18n:
|
||
generated_at: "2026-02-01T19:21:46Z"
|
||
model: claude-opus-4-5
|
||
provider: pi
|
||
source_hash: 5602ef105c3da7e47497bfed8fc343dd8d7f3c019ff7e423a08b25092c5a1837
|
||
source_path: channels/location.md
|
||
workflow: 14
|
||
---
|
||
|
||
# 渠道位置解析
|
||
|
||
OpenClaw 将聊天渠道中分享的位置标准化为：
|
||
|
||
- 附加到入站消息体的可读文本，以及
|
||
- 自动回复上下文负载中的结构化字段。
|
||
|
||
目前支持：
|
||
|
||
- **Telegram**（位置图钉 + 地点 + 实时位置）
|
||
- **WhatsApp**（locationMessage + liveLocationMessage）
|
||
- **Matrix**（`m.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`（字符串；可选）
|
||
- `LocationSource`（`pin | place | live`）
|
||
- `LocationIsLive`（布尔值）
|
||
|
||
## 渠道说明
|
||
|
||
- **Telegram**：地点映射到 `LocationName/LocationAddress`；实时位置使用 `live_period`。
|
||
- **WhatsApp**：`locationMessage.comment` 和 `liveLocationMessage.caption` 作为标题行附加。
|
||
- **Matrix**：`geo_uri` 解析为图钉位置；忽略海拔高度，`LocationIsLive` 始终为 false。
|