English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Nodes and media

Commande de localisation

TL;DR

  • location.get est une commande de nœud (via node.invoke).
  • Désactivée par défaut.
  • Les paramètres de l’application Android utilisent un sélecteur : Désactivé / Lors de l’utilisation.
  • Option séparée : localisation précise.

Pourquoi un sélecteur (et pas seulement un interrupteur)

Les autorisations du système d’exploitation comportent plusieurs niveaux. Nous pouvons exposer un sélecteur dans l’application, mais le système d’exploitation décide toujours de l’autorisation réelle.

  • iOS/macOS peuvent exposer Lors de l’utilisation ou Toujours dans les invites système/Paramètres.
  • L’application Android prend actuellement uniquement en charge la localisation au premier plan.
  • La localisation précise est une autorisation séparée (iOS 14+ « Precise », Android « fine » vs « coarse »).

Le sélecteur dans l’interface utilisateur pilote le mode que nous demandons ; l’autorisation réelle se trouve dans les paramètres du système d’exploitation.

Modèle de paramètres

Par appareil de nœud :

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

Comportement de l’interface utilisateur :

  • Sélectionner whileUsing demande l’autorisation au premier plan.
  • Si le système d’exploitation refuse le niveau demandé, revenir au niveau le plus élevé accordé et afficher l’état.

Correspondance des autorisations (node.permissions)

Facultatif. Le nœud macOS signale location via la carte des autorisations ; iOS/Android peuvent l’omettre.

Commande : location.get

Appelée via node.invoke.

Paramètres (suggérés) :

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

Charge utile de réponse :

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

Erreurs (codes stables) :

  • LOCATION_DISABLED : le sélecteur est désactivé.
  • LOCATION_PERMISSION_REQUIRED : autorisation manquante pour le mode demandé.
  • LOCATION_BACKGROUND_UNAVAILABLE : l’application est en arrière-plan, mais seul Lors de l’utilisation est autorisé.
  • LOCATION_TIMEOUT : aucune position obtenue à temps.
  • LOCATION_UNAVAILABLE : défaillance système / aucun fournisseur.

Comportement en arrière-plan

  • L’application Android refuse location.get lorsqu’elle est en arrière-plan.
  • Gardez OpenClaw ouvert lors de la demande de localisation sur Android.
  • Les autres plateformes de nœud peuvent différer.

Intégration modèle/outillage

  • Surface d’outil : l’outil nodes ajoute l’action location_get (nœud requis).
  • CLI : openclaw nodes location get --node <id>.
  • Directives pour les agents : appeler uniquement lorsque l’utilisateur a activé la localisation et comprend la portée.

Texte UX (suggéré)

  • Désactivé : « Le partage de localisation est désactivé. »
  • Lors de l’utilisation : « Uniquement quand OpenClaw est ouvert. »
  • Précise : « Utiliser la localisation GPS précise. Désactivez cette option pour partager une localisation approximative. »

Associé