配置
渠道位置解析
OpenClaw 将聊天渠道中的共享位置规范化为：
- 附加到入站正文的精简坐标文本，以及
- 自动回复上下文负载中的结构化字段。渠道提供的标签、地址以及说明/评论由共享的不受信任元数据 JSON 块呈现到提示词中，而不是以内联方式放入用户正文。
目前支持：
- LINE（包含标题/地址的位置消息）
- Matrix（包含
geo_uri的m.location） - Telegram（位置标记 + 地点 + 实时位置）
- WhatsApp（
locationMessage+liveLocationMessage）
文本格式化
位置信息会呈现为不带括号的易读文本行。坐标保留六位小数；精度四舍五入到整米：
- 固定位置：
📍 48.858844, 2.294351 ±12m
- 命名地点（同一行；名称/地址仅进入元数据块）：
📍 48.858844, 2.294351 ±12m
- 实时位置共享：
🛰 Live location: 48.858844, 2.294351 ±12m
如果渠道包含标签、地址或说明/评论，这些内容会保留在上下文载荷中，并以围栏包裹的不受信任 JSON 形式显示在提示词里（字段不存在时会被省略）：
位置（不受信任的元数据）：```json{ "latitude": 48.858844, "longitude": 2.294351, "accuracy_m": 12, "source": "place", "name": "埃菲尔铁塔", "address": "巴黎战神广场", "caption": "在这里见面"}```上下文字段
存在位置信息时，会将以下字段添加到 ctx：
LocationLat（数字）LocationLon（数字）LocationAccuracy（数字，单位为米；可选）LocationName（字符串；可选）LocationAddress（字符串；可选）LocationSource（pin | place | live）LocationIsLive（布尔值）LocationCaption（字符串；可选）
当渠道未设置明确的来源时，OpenClaw 会进行推断：实时共享位置归为 live，带有名称或地址的位置归为 place，其他位置均归为 pin。
提示词渲染器将 LocationName、LocationAddress 和 LocationCaption 视为不可信元数据，并通过与其他渠道上下文相同的有界 JSON 路径对其进行序列化。
出站载荷
消息工具和插件 SDK 对可移植的出站位置使用相同的 NormalizedLocation 结构。仅含坐标的载荷表示一个位置标记。支持原生地点功能的渠道可以将 name 和 address 映射为地点卡片。
Telegram 目前通过 message(action="send") 提供此功能。其首个实现有意保持独立：位置载荷不能与文本或媒体混合使用，并且地点名称和地址不完整时会直接失败，而不是静默丢弃名称或地址。不支持此功能的渠道不会提供位置参数。
渠道说明
- LINE：位置消息的
title/address映射到LocationName/LocationAddress；不支持实时位置。 - Matrix：
geo_uri会被解析为位置标记；u（不确定度）参数映射到LocationAccuracy，事件正文填充LocationCaption，海拔信息会被忽略，并且LocationIsLive始终为 false。 - Telegram：地点映射到
LocationName/LocationAddress；通过live_period检测实时位置。 - WhatsApp：
locationMessage.comment和liveLocationMessage.caption用于填充LocationCaption。
相关内容
Was this useful?
