Aller au contenu
Guides

Le partage de position dans OpenClaw

Comment les épingles, les lieux et les positions en direct de LINE, Matrix, Telegram et WhatsApp atteignent l’agent, les champs de contexte, et la charge de position sortante

4 min de lecture

Une épingle déposée est un petit message avec beaucoup de structure, et chaque plateforme l’encode différemment. OpenClaw normalise les positions partagées depuis les canaux de chat en deux choses : une ligne de coordonnées concise ajoutée au corps entrant, et des champs structurés dans la charge de contexte de réponse automatique, tout libellé, adresse ou légende fourni par le canal étant rendu par le bloc partagé de métadonnées non fiables plutôt qu’inline dans le corps de l’utilisateur. Voici les canaux pris en charge, les formats de texte, les champs de contexte, la charge sortante, et les notes par canal.

Entrant

  • Quatre canaux sont pris en charge aujourd’hui : les messages de position LINE avec titre et adresse, les événements de position Matrix avec un URI géographique, les épingles, lieux et positions en direct de Telegram, et les messages de position et de position en direct de WhatsApp.
  • Les positions se rendent en lignes lisibles sans crochets, coordonnées à six décimales et précision arrondie au mètre : une épingle est un marqueur avec les coordonnées et la précision, un lieu nommé est la même ligne avec le nom et l’adresse qui ne vont que dans le bloc de métadonnées, et un partage en direct est un marqueur satellite avec un libellé de position en direct.
  • Quand le canal fournit un libellé, une adresse ou une légende, ils sont préservés dans la charge de contexte et apparaissent dans le prompt comme JSON non fiable délimité avec latitude, longitude, précision, source, nom, adresse et légende, les champs absents étant omis.
  • Le contexte gagne des nombres de latitude et de longitude, une précision facultative en mètres, des chaînes facultatives de nom et d’adresse, une source épingle, lieu ou direct, un indicateur de direct et une légende facultative ; quand le canal ne fixe pas de source explicite, les partages en direct deviennent direct, les positions avec un nom ou une adresse deviennent lieu, et tout le reste est une épingle. Le moteur de rendu du prompt traite le nom, l’adresse et la légende comme métadonnées non fiables sérialisées par le même chemin JSON borné que le reste du contexte des canaux.
Les lieux sont rendus sous forme de lignes lisibles sans crochets.

Sortant

L’outil de message et le SDK d’extensions utilisent une seule forme de position normalisée pour les positions sortantes portables : une charge à coordonnées seules représente une épingle, et les canaux avec une prise en charge native des lieux peuvent convertir un nom plus une adresse en carte de lieu. Telegram l’expose par l’action d’envoi de l’outil de message, et sa première implémentation est volontairement autonome : les charges de position ne peuvent pas se mêler au texte ou aux médias, et les paires de lieu incomplètes échouent plutôt que d’abandonner en silence un nom ou une adresse. Les canaux qui ne le prennent pas en charge n’annoncent pas du tout le paramètre de position, si bien que l’agent ne peut pas tenter d’envoyer une épingle là où aucune ne peut atterrir.

Notes par canal

  • LINE convertit le titre et l’adresse du message de position en champs de nom et d’adresse et n’a pas de positions en direct.
  • Matrix analyse l’URI géographique comme une épingle, convertit son paramètre d’incertitude en précision, remplit la légende depuis le corps de l’événement, ignore l’altitude, et ne marque jamais une position comme en direct.
  • Telegram convertit les lieux en nom et adresse et détecte les positions en direct par le champ de durée de direct ; WhatsApp remplit la légende depuis le commentaire du message de position ou la légende de la position en direct.

OpenClaw sur WhatsApp et OpenClaw sur Telegram sont les deux canaux connectés où une épingle partagée atteint l’assistant de cette façon.

Surfaces voisines

L’analyse des positions concerne ce qu’un message de chat transporte ; l’agent peut aussi demander à un appareil appairé sa position ou une photo par des commandes de nœuds, un chemin différent avec ses propres approbations. OpenClaw sur Matrix couvre les événements à URI géographique, et Les nœuds d’OpenClaw, les mains distantes les appareils appairés avec leur propre commande de position.

Sur Diali

Sur Diali, une épingle partagée sur WhatsApp ou Telegram atteint l’assistant sous la même ligne de coordonnées et le même bloc de métadonnées non fiables, et la carte de lieu sortante est la partie réservée à Telegram. OpenClaw hébergé sur Diali est l’assistant et La sécurité chez Diali décrit comment les métadonnées non fiables sont tenues à l’écart des instructions.

  • Six décimales, des mètres entiers, pas de crochets.
  • Les noms et les légendes sont des métadonnées, jamais des instructions.
  • Une forme sortante ; Telegram l’envoie seule.
Commencer

Arrêtez de lire, construisez le vôtre

Configurez un agent, choisissez un canal, et faites-le travailler dans l’application que vous gardez déjà ouverte.