> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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):

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "timeoutMs": 10000,
  "maxAgeMs": 15000,
  "desiredAccuracy": "coarse|balanced|precise"
}
```

Antwort-Payload:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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](/de/channels/location)
* [Kameraaufnahme](/de/nodes/camera)
* [Sprechmodus](/de/nodes/talk)