Zum Hauptinhalt springen

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.

​
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