Aller au contenu
Guides

OpenClaw sur Matrix

L’extension, l’authentification par jeton ou mot de passe, l’adhésion automatique désactivée par défaut, et le chiffrement de bout en bout

5 min de lecture

Matrix est une extension de canal téléchargeable construite sur le SDK Matrix officiel, et elle couvre plus du protocole que la plupart des bots : messages privés, salons, fils, médias, réactions, sondages, position, et chiffrement de bout en bout. Node est l’environnement recommandé et le chiffrement exige les liaisons cryptographiques natives du SDK pour votre plateforme. Voici l’installation et les deux façons de s’authentifier, la règle d’adhésion automatique qui surprend en premier, les pages de chiffrement et de vérification, et les règles de compte sur lesquelles la documentation est stricte.

Configuration

  • Installez l’extension ; elle vient de npm d’abord et se rabat sur son paquet ClawHub, et l’installation l’enregistre et l’active, bien que le canal ne fasse rien tant qu’il n’est pas configuré.
  • Configurez un serveur d’accueil plus un jeton d’accès, ou un serveur d’accueil plus un identifiant d’utilisateur et un mot de passe, auquel cas la première connexion frappe et met en cache un jeton ; puis sondez l’état du canal et démarrez la passerelle si elle est hors ligne.
  • Ou prenez l’assistant : URL du serveur d’accueil, méthode d’authentification, identifiant d’utilisateur pour le mot de passe, un nom d’appareil facultatif, l’activation ou non du chiffrement, et l’accès aux salons ; des variables d’environnement Matrix existantes peuvent être adoptées, et les noms de salons devraient être résolus en identifiants avant d’enregistrer une liste d’autorisation.
OpenClaw ne peut pas savoir au moment de l’invitation si elle concerne un message privé ou un groupe, si bien que chaque invitation passe d’abord par autoJoin ; dm.policy ne s’applique que plus tard, une fois que le bot a rejoint et que le salon est classé.

Adhésion automatique et listes d’autorisation

L’adhésion automatique est désactivée par défaut, si bien que le bot n’apparaît dans aucun nouveau salon ni message privé issu d’une invitation fraîche tant que vous ne le rejoignez pas à la main. Une liste d’autorisation n’accepte que des identifiants de salon littéraux, des alias ou un joker, jamais des noms de salons en clair, et toujours accepte chaque invitation. Quand le bot rejoint un salon de groupe autorisé, il poste une présentation fondée sur le nom du salon, son sujet et ses messages récents, jamais dans un salon direct, et cela peut être désactivé. Les identifiants d’utilisateurs sont sensibles à la casse et se copient exactement ; les noms d’affichage sont ignorés sauf si vous activez l’indicateur dont le nom commence par dangerously.

Chiffrement

  • La page de chiffrement couvre l’activation du E2EE, la vérification de l’appareil de la passerelle avec une clé de récupération, l’amorçage ou la réparation de la signature croisée, la sauvegarde des clés de salon et la disposition du magasin cryptographique, avec des notes par compte.
  • Activer le chiffrement dans l’assistant lance le même amorçage que la commande de configuration du chiffrement.
  • La page de migration couvre les limites de la récupération de l’état chiffré et le flux de mise à niveau, lecture obligatoire avant tout déplacement de la passerelle vers une autre machine.

Bonnes pratiques de sécurité pour OpenClaw est la liste de contrôle plus large, et OpenClaw ne répond pas l’échelle pour un bot qui a rejoint et ne dit rien.

Comptes et serveurs d’accueil

Plusieurs comptes vivent sous des entrées nommées qui héritent des valeurs de premier niveau ; un serveur d’accueil privé ou en réseau local exige l’indicateur de réseau privé, un proxy peut être défini par compte, et le jeton comme le mot de passe acceptent des références de secret selon les règles partagées d’alias de fournisseur. Le fichier de configuration d’OpenClaw explique où ces références se résolvent.

Sur Diali

Matrix figure dans la liste des canaux connectables de Diali : l’extension, l’environnement et les liaisons cryptographiques sont à nous à exploiter, et le compte sur le serveur d’accueil comme la liste d’autorisation des salons sont à vous. OpenClaw hébergé sur Diali est l’assistant et La sécurité sur Diali décrit la frontière.

  • Jeton ou mot de passe ; le chemin du mot de passe met un jeton en cache.
  • L’adhésion automatique est désactivée ; les invitations vous attendent, ou attendent une liste d’identifiants de salons.
  • Le E2EE exige les liaisons natives et un appareil vérifié.
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.