Pular para o conteúdo principal

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.

O OpenClaw normaliza localizações compartilhadas de canais de chat em:
  • texto conciso de coordenadas anexado ao corpo de entrada, e
  • campos estruturados na carga de contexto de resposta automática. Rótulos, endereços e legendas/comentários fornecidos pelo canal são renderizados no prompt pelo bloco JSON compartilhado de metadados não confiáveis, não inline no corpo do usuário.
Atualmente compatível com:
  • Telegram (pins de localização + locais + localizações ao vivo)
  • WhatsApp (locationMessage + liveLocationMessage)
  • Matrix (m.location com geo_uri)

​
Formatação de texto

As localizações são renderizadas como linhas amigáveis sem colchetes:
  • Pin:
    • 📍 48.858844, 2.294351 ±12m
  • Local nomeado:
    • 📍 48.858844, 2.294351 ±12m
  • Compartilhamento ao vivo:
    • 🛰 Localização ao vivo: 48.858844, 2.294351 ±12m
Se o canal incluir um rótulo, endereço ou legenda/comentário, isso será preservado na carga de contexto e aparecerá no prompt como JSON não confiável delimitado: 
Location (untrusted metadata):
```json
{
  "latitude": 48.858844,
  "longitude": 2.294351,
  "name": "Eiffel Tower",
  "address": "Champ de Mars, Paris",
  "caption": "Meet here"
}
```

​
Campos de contexto

Quando uma localização está presente, estes campos são adicionados a ctx:
  • LocationLat (number)
  • LocationLon (number)
  • LocationAccuracy (number, metros; opcional)
  • LocationName (string; opcional)
  • LocationAddress (string; opcional)
  • LocationSource (pin | place | live)
  • LocationIsLive (boolean)
  • LocationCaption (string; opcional)
O renderizador de prompt trata LocationName, LocationAddress e LocationCaption como metadados não confiáveis e os serializa pelo mesmo caminho JSON limitado usado para outros contextos de canal.

​
Observações por canal

  • Telegram: locais são mapeados para LocationName/LocationAddress; localizações ao vivo usam live_period.
  • WhatsApp: locationMessage.comment e liveLocationMessage.caption preenchem LocationCaption.
  • Matrix: geo_uri é analisado como uma localização de pin; a altitude é ignorada e LocationIsLive é sempre false.

​
Relacionado