Standortbefehl

# Kurzfassung

• location.get ist ein Node-Befehl (über node.invoke).
• Standardmäßig deaktiviert.
• Android-App-Einstellungen verwenden eine Auswahl: Aus / Während der Nutzung.
• Separater Schalter: Genauer Standort.

# Warum eine Auswahl (nicht nur ein Schalter)

OS-Berechtigungen haben mehrere Ebenen. Wir können in der App eine Auswahl bereitstellen, aber das OS entscheidet weiterhin über die tatsächlich gewährte Berechtigung.

• iOS/macOS können Während der Nutzung oder Immer in Systemabfragen/Einstellungen anzeigen.
• Die Android-App unterstützt derzeit nur Standortzugriff im Vordergrund.
• Genauer Standort ist eine separate Berechtigung (iOS 14+ „Genau“, Android „fine“ vs. „coarse“).

Die Auswahl in der UI steuert unseren angeforderten Modus; die tatsächliche Berechtigung liegt in den OS-Einstellungen.

# Einstellungsmodell

Pro Node-Gerät:

• location.enabledMode: off | whileUsing
• location.preciseEnabled: bool

UI-Verhalten:

• Die Auswahl von whileUsing fordert Vordergrundberechtigung an.
• Wenn das OS die angeforderte Ebene verweigert, auf die höchste gewährte Ebene zurücksetzen und den Status anzeigen.

# Berechtigungszuordnung (node.permissions)

Optional. macOS-Node meldet location über die Berechtigungszuordnung; iOS/Android können dies auslassen.

# Befehl: location.get

Aufgerufen über node.invoke.

Parameter (vorgeschlagen):

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

Antwort-Payload:

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

Fehler (stabile Codes):

• LOCATION_DISABLED: Auswahl ist aus.
• LOCATION_PERMISSION_REQUIRED: Berechtigung für den angeforderten Modus fehlt.
• LOCATION_BACKGROUND_UNAVAILABLE: App läuft im Hintergrund, aber nur Während der Nutzung ist erlaubt.
• LOCATION_TIMEOUT: Keine Positionsbestimmung innerhalb der Zeit.
• LOCATION_UNAVAILABLE: Systemfehler / keine Provider.

# Verhalten im Hintergrund

• Android-App verweigert location.get, während sie im Hintergrund läuft.
• Halten Sie OpenClaw geöffnet, wenn Sie unter Android Standort anfordern.
• Andere Node-Plattformen können abweichen.

# Modell-/Tooling-Integration

• Tool-Oberfläche: Das nodes-Tool fügt die Aktion location_get hinzu (Node erforderlich).
• CLI: openclaw nodes location get --node <id>.
• Agent-Richtlinien: Nur aufrufen, wenn der Benutzer Standort aktiviert hat und den Umfang versteht.

# UX-Text (vorgeschlagen)

• Aus: „Standortfreigabe ist deaktiviert.“
• Während der Nutzung: „Nur wenn OpenClaw geöffnet ist.“
• Genauer Standort: „Genauen GPS-Standort verwenden. Deaktivieren, um ungefähren Standort zu teilen.“

# Verwandt

• Channel-Standortparsing
• Kameraaufnahme
• Sprechmodus