Cómo obtener la ubicación de tus nodes con location.get

Gestionar la ubicación en diferentes sistemas operativos suele ser un dolor de cabeza. Entre los permisos de “Siempre” o “Solo al usar la app” y la diferencia entre ubicación exacta o aproximada, es fácil que la implementación se vuelva caótica.

Esta guía te ayuda a integrar el comando location.get en tus nodes de forma directa, respetando las restricciones de privacidad de iOS, Android y macOS.

Requisitos previos

• Un node activo y conectado.
• Acceso a los settings del dispositivo para gestionar permisos del OS.
• La CLI de OpenClaw instalada.
• Conocimiento de los estados de location.enabledMode (off, whileUsing, always).

Inicio rápido

Para obtener la ubicación de un node en menos de 5 minutos, sigue estos pasos:

1. Configura el modo de ubicación: En los ajustes del node, cambia location.enabledMode a whileUsing o always. Si necesitas máxima exactitud, activa también location.preciseEnabled.
2. Ejecuta el comando: Usa la CLI para solicitar la ubicación actual del dispositivo:

   openclaw nodes location get --node <id>

Detalles técnicos de location.get

El comando se ejecuta mediante node.invoke. Puedes ajustar la petición con los siguientes parámetros:

{
  "timeoutMs": 10000,
  "maxAgeMs": 15000,
  "desiredAccuracy": "coarse|balanced|precise"
}

Si la petición tiene éxito, recibirás un payload con este formato:

{
  "lat": 48.20849,
  "lon": 16.37208,
  "accuracyMeters": 12.5,
  "altitudeMeters": 182.0,
  "speedMps": 0.0,
  "headingDeg": 270.0,
  "timestamp": "2026-01-03T12:34:56.000Z",
  "isPrecise": true,
  "source": "gps|wifi|cell|unknown"
}

Solución de problemas

Si el comando falla, revisa estos códigos de error comunes:

• LOCATION_DISABLED: El selector de ubicación en los settings está en off.
• LOCATION_PERMISSION_REQUIRED: El sistema operativo no ha otorgado el permiso para el modo solicitado.
• LOCATION_BACKGROUND_UNAVAILABLE: Intentaste obtener la ubicación en segundo plano, pero solo tienes permiso “While Using”.
• LOCATION_TIMEOUT: El dispositivo no logró fijar la posición en el tiempo establecido.

Conclusión

Implementar la ubicación requiere entender que el OS tiene la última palabra sobre los permisos. Configura siempre el selector en tu UI para que coincida con la lógica de tu aplicación y maneja los errores de permisos para guiar al usuario a los ajustes del sistema.

Si tienes dudas sobre la integración en un flujo específico, consulta al AI Setup Assistant.

Próximos pasos

• Node Permissions Mapping
• Gateway Push Flows
• CLI Command Reference
• Background Location Modes