Aller au contenu
Guides

OpenClaw sur Tlon

Un vaisseau Urbit comme canal, des groupes conditionnés par mention, le flux d’approbation du propriétaire, des listes d’autorisation qui échouent fermées, et des réglages rechargés à chaud depuis le vaisseau

6 min de lecture

Tlon est une messagerie décentralisée bâtie sur Urbit, et OpenClaw se connecte à votre vaisseau Urbit pour répondre aux messages privés et aux messages de conversations de groupe. Les réponses de groupe exigent une mention par défaut, avec des règles d’autorisation et un flux d’approbation du propriétaire par-dessus. Il est livré comme extension intégrée prenant en charge les messages privés, les mentions de groupe, les fils, le texte enrichi, l’envoi et la réception d’images et le système d’approbation ; les réactions et les sondages ne sont pas pris en charge nativement. Voici la configuration, la durabilité, l’option de vaisseau privé, les canaux de groupe, le contrôle d’accès, le flux du propriétaire, l’acceptation automatique, le rechargement à chaud du magasin de réglages, et la compétence intégrée.

Configuration et durabilité

  • Ajoutez le canal avec le nom du vaisseau, l’URL du vaisseau et le code de connexion, ou écrivez la même chose dans la configuration avec un vaisseau propriétaire, recommandé, qui est toujours autorisé ; le code de connexion est le code de connexion web du vaisseau affiché par la commande de code dans le dojo, et il tourne, donc relisez-le chaque fois que l’authentification commence à échouer. Les changements de configuration se rechargent à chaud, et la sonde d’état du canal confirme la connexion.
  • Les événements acceptés de messages privés et de conversations de groupe sont conservés avant la distribution à l’agent, si bien que les tours en attente ou relançables survivent à un redémarrage de la passerelle, que le travail reste sérialisé par canal de groupe ou par correspondant direct, et que des identifiants de messages Urbit stables suppriment les événements relivrés tant qu’un enregistrement de file ou d’achèvement existe ; la livraison est au moins une fois à travers la frontière entre file et agent, donc les actions à effets de bord doivent rester idempotentes.
  • Les vaisseaux privés ou en réseau local sont bloqués par défaut par la protection contre les SSRF ; un réglage réseau accepte explicitement une URL de vaisseau de confiance, en désactivant cette protection pour les requêtes de ce compte, et l’ancienne clé plate est migrée par la correction du doctor.
  • Les canaux de groupe sont épinglés manuellement par nid ou découverts automatiquement : avec la découverte activée, la passerelle interroge les groupes rejoints au démarrage, surveille les nouveaux canaux à mesure que les invitations sont acceptées, et revérifie toutes les deux minutes ; le réglage est désactivé par défaut dans la configuration, bien que l’assistant de configuration propose oui par défaut.
Sans ownerShip configuré, les messages privés et les mentions de canal non autorisés sont simplement abandonnés et journalisés ; il n’y a pas d’invite d’approbation.

Contrôle d’accès et propriétaire

La liste d’autorisation des messages privés est vide par défaut, ce qui signifie qu’aucun message privé n’est autorisé sauf si l’expéditeur est le vaisseau propriétaire. L’autorisation de groupe vaut restreinte par défaut pour chaque canal, avec une base de vaisseaux autorisés par défaut et des règles par nid qui fixent restreint avec une liste autorisée ou ouvert. Une fois que le bot a répondu dans un fil, il continue d’y répondre sans nouvelle mention, sauf si la participation aux fils est désactivée dans le réglage des mentions implicites. Le vaisseau propriétaire est autorisé partout : ses invitations privées et de groupe sont toujours acceptées automatiquement et ses messages de canal passent toujours, sans figurer dans aucune liste. Avec un propriétaire défini, les requêtes non autorisées ne sont pas abandonnées mais mises en file comme approbations en attente avec un message privé au propriétaire : messages privés de vaisseaux hors liste, mentions d’expéditeurs échouant à l’autorisation, et invitations de groupe de vaisseaux hors liste d’invitations. Le propriétaire répond en message privé avec approuver, refuser ou bloquer pour la requête la plus récente ou avec un identifiant pour une requête précise ; bloquer bloque aussi le vaisseau nativement pour qu’il ne puisse pas se reconnecter, débloquer l’annule, et bloqués et en attente listent l’état courant.

Acceptation automatique, rechargement à chaud, compétence

  • Les invitations privées de vaisseaux déjà sur la liste peuvent être acceptées automatiquement, le propriétaire l’est toujours, et les invitations de groupe peuvent être acceptées automatiquement depuis une liste d’invitations qui échoue fermée : avec l’acceptation automatique activée et une liste vide, aucune invitation hors propriétaire n’est acceptée.
  • La plupart de ces réglages sont reflétés dans l’agent de réglages du vaisseau au premier lancement puis lus en direct depuis là, si bien que les changements faits par un client Landscape ou par la compétence intégrée s’appliquent sans redémarrage de la passerelle ; les règles de canaux et les approbations en attente y sont aussi conservées, et la configuration en fichier reste la source de vérité pour les valeurs jamais écrites dans le magasin.
  • L’extension embarque la compétence CLI de Tlon pour les opérations Urbit directes, activité, canaux, contacts, groupes, hooks, historique et recherche de messages, messages privés y compris les réactions, publications, entrées de carnet et réglages, ce qui est aussi le seul moyen de réagir. Un plafond de médias en mébioctets borne les téléchargements entrants et les envois sortants sous un plafond de six mébioctets, les réponses de fil atterrissent dans le fil avec les dix derniers messages de contexte ajoutés en tête, le Markdown se convertit au format natif de Tlon, et un message demandant un résumé de canal déclenche une synthèse d’historique intégrée. Les cibles de livraison pour les envois et cron sont un nom de vaisseau pour les messages privés et un nid de chat pour les groupes.

OpenClaw sur Matrix et OpenClaw sur Nostr sont les autres réseaux décentralisés qu’OpenClaw parle, chacun avec son propre modèle de confiance.

Sur Diali

Tlon ne fait pas partie des canaux que Diali connecte aujourd’hui : WhatsApp, Telegram, Discord, Slack, Mattermost, Matrix, SMS et voix. Connecter votre premier canal en cinq minutes explique comment ceux-là sont reliés, et La sécurité chez Diali la frontière qui s’applique à chacun d’eux.

Dépannage

Des messages privés ignorés signifient un expéditeur hors liste sans propriétaire configuré pour le flux d’approbation ; des messages de groupe ignorés signifient un canal non découvert ou non épinglé ou un expéditeur échouant à l’autorisation sans propriétaire pour mettre une approbation en file ; les erreurs de connexion pointent vers l’URL du vaisseau ou l’option de réseau privé ; et les erreurs d’authentification signifient un code de connexion qui a tourné. OpenClaw hébergé sur Diali est l’assistant et Les extensions d’OpenClaw la surface dans laquelle Tlon est livré.

  • Un vaisseau, une URL, un code de connexion qui tourne.
  • Des groupes conditionnés par mention ; un propriétaire qui approuve le reste.
  • Les listes échouent fermées ; les réglages vivent sur le vaisseau.
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.