Cómo procesar ubicaciones de canales con OpenClaw

Lidiar con datos de ubicación provenientes de diferentes plataformas de chat suele ser un dolor de cabeza. Cada API envía las coordenadas y los metadatos en formatos totalmente distintos, lo que te obliga a escribir lógica personalizada para cada integración.

OpenClaw elimina esta complejidad normalizando las ubicaciones compartidas. Convierte los datos en texto legible para humanos y en campos estructurados dentro del context payload de respuesta automática, permitiéndote procesar coordenadas de forma uniforme.

Requisitos previos

• Una instancia de OpenClaw activa.
• Configuración de canales para Telegram, WhatsApp o Matrix.

Inicio rápido

OpenClaw detecta automáticamente los mensajes de ubicación y los transforma por ti. No necesitas configurar parsers adicionales para obtener los datos.

Formato de texto generado

Cuando recibes una ubicación, OpenClaw añade una línea de texto amigable al cuerpo del mensaje. Aquí tienes los formatos que genera:

• Pin estándar: 📍 48.858844, 2.294351 ±12m
• Lugar con nombre: 📍 Eiffel Tower — Champ de Mars, Paris (48.858844, 2.294351 ±12m)
• Ubicación en tiempo real: 🛰 Live location: 48.858844, 2.294351 ±12m

Si el usuario incluye un comentario o descripción en WhatsApp o Telegram, aparecerá en la siguiente línea:

📍 48.858844, 2.294351 ±12m
Nos vemos aquí

Campos en el Contexto

Para procesar la ubicación mediante código o lógica de bot, utiliza estos campos disponibles en ctx:

• LocationLat: Latitud (number).
• LocationLon: Longitud (number).
• LocationAccuracy: Precisión en metros (number, opcional).
• LocationName: Nombre del lugar (string, opcional).
• LocationAddress: Dirección física (string, opcional).
• LocationSource: Origen del dato (pin | place | live).
• LocationIsLive: Indica si es tiempo real (boolean).

Solución de problemas

• Telegram: Si usas venues, se mapean directamente a LocationName y LocationAddress. Las ubicaciones en tiempo real utilizan el parámetro live_period internamente.
• WhatsApp: Los comentarios en locationMessage y los subtítulos en liveLocationMessage se extraen automáticamente.
• Matrix: OpenClaw procesa el geo_uri como un pin. Ten en cuenta que la altitud se ignora y LocationIsLive siempre será false.
• Datos faltantes: Algunos campos como LocationAccuracy o LocationAddress son opcionales; asegúrate de que tu lógica maneje valores nulos.

¿Necesitas ayuda para configurar estos campos en tu flujo de trabajo? Prueba el AI Setup Assistant.

Próximos pasos

• Estructura del Payload de Auto-reply
• Configuración de Webhooks