Standortdaten von Nodes abrufen mit location.get

Standortabfragen in verteilten Systemen sind oft ein Albtraum. Man kämpft mit unterschiedlichen Berechtigungsebenen der Betriebssysteme und unzuverlässigen Timeouts, während die App eigentlich nur wissen will, wo sich ein Node gerade befindet.

Die Koordination zwischen App-Einstellungen und tatsächlichen OS-Freigaben führt häufig zu Fehlern, die schwer zu debuggen sind. Besonders der Wechsel zwischen Vordergrund- und Hintergrundzugriff macht die Implementierung komplex.

Voraussetzungen

• Ein aktiver Node, der node.invoke unterstützt.
• Installiertes openclaw CLI für manuelle Abfragen.

Schnellstart

Die Standortfunktion ist standardmäßig deaktiviert. Um sie zu nutzen, musst du den Modus in den Node-Einstellungen anpassen.

1. Modus wählen: Setze location.enabledMode auf whileUsing oder always.
2. Präzision festlegen: Aktiviere location.preciseEnabled für exakte GPS-Daten.
3. Befehl ausführen: Nutze node.invoke, um den Befehl location.get zu senden.

Hier ist ein Beispiel für den API-Aufruf:

{
  "timeoutMs": 10000,
  "maxAgeMs": 15000,
  "desiredAccuracy": "balanced"
}

Wenn der Node antwortet, erhältst du ein Payload mit den Koordinaten:

{
  "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"
}

Für schnelle Tests über das CLI verwendest du diesen Befehl: openclaw nodes location get --node <id>

Fehlerbehebung

Falls die Abfrage fehlschlägt, geben die Error Codes Aufschluss über die Ursache:

• LOCATION_DISABLED: Der Selector in den Einstellungen steht auf “Off”.
• LOCATION_PERMISSION_REQUIRED: Die OS-Berechtigung für den gewählten Modus fehlt.
• LOCATION_BACKGROUND_UNAVAILABLE: Die App ist im Hintergrund, aber nur “While Using” ist erlaubt.
• LOCATION_TIMEOUT: Es konnte innerhalb des Zeitlimits kein Standort ermittelt werden.
• LOCATION_UNAVAILABLE: Systemfehler oder keine verfügbaren Provider (GPS/WiFi).

Beachte, dass unter iOS und Android für den Hintergrundzugriff oft manuelle Schritte in den Systemeinstellungen des Nutzers nötig sind. Wenn das OS eine Ebene verweigert, fällt das System automatisch auf die höchste genehmigte Stufe zurück.

Bereit für das Setup? Nutze den AI Setup Assistant für Unterstützung bei der Konfiguration.

Nächste Schritte

• Node Permissions API Reference
• Gateway Push Configuration Guide
• CLI Command Overview
• Background Tasks and Power Management