Configurer Matrix dans OpenClaw

Matrix est le seul canal où OpenClaw n’est qu’un client parmi d’autres sur un serveur que vous choisissez, donc la configuration porte surtout sur les identifiants et les invitations : comment le bot se connecte, quelles invitations il accepte, et comment les entrées de liste doivent s’écrire. Voici l’installation, les options d’authentification et l’assistant, la règle d’adhésion automatique qui surprend, les formats de cible, et les détails d’environnement et de cache.

Installation et authentification

• L’extension s’installe avec la commande d’installation d’extensions pour le paquet Matrix, depuis npm d’abord avec un repli sur son paquet ClawHub déclaré seulement quand la cible npm est indisponible, avec des préfixes npm ou clawhub pour forcer une source et un chemin local pour le développement ; l’installation enregistre et active l’extension, et le canal ne fait rien tant qu’il n’est pas configuré.
• La configuration tient en quatre étapes : créer un compte Matrix sur le serveur, configurer le bloc du canal avec le serveur et un jeton d’accès ou avec le serveur, un identifiant d’utilisateur et un mot de passe, le jeton étant créé dans un client ou l’interface d’administration et l’authentification par mot de passe en frappant un et le mettant en cache à la première connexion, vérifier la sonde d’état et démarrer la passerelle si elle est hors ligne, puis ouvrir un message privé ou inviter le bot dans un salon, en se rappelant que les nouvelles invitations n’aboutissent que si l’adhésion automatique les autorise.
• Le chemin interactif est la commande d’ajout de canal ou la section des canaux de la commande de configuration : l’assistant demande l’URL du serveur, la méthode d’authentification, l’identifiant d’utilisateur pour le mot de passe, un nom d’appareil facultatif, l’activation du chiffrement de bout en bout, et l’accès aux salons et l’adhésion automatique, propose un raccourci par variables d’environnement quand des variables Matrix correspondantes existent et que le compte n’a pas d’authentification enregistrée, résout les noms de salons par la commande de résolution des canaux avant d’enregistrer une liste, et activer le chiffrement lance le même amorçage que la commande de configuration du chiffrement.
• La configuration minimale par jeton active le canal avec le serveur, le jeton et une politique d’appairage pour les messages privés, la configuration par mot de passe ajoute l’identifiant d’utilisateur, le mot de passe et un nom d’appareil avec le jeton mis en cache après la première connexion, et les références de secret pour le jeton et le mot de passe suivent les règles partagées d’alias de fournisseur, y compris pour les comptes nommés, où un fournisseur d’environnement explicite applique toujours sa liste et où une liste vide refuse toute variable.

OpenClaw ne peut pas savoir au moment de l’invitation si elle concerne un message privé ou un groupe, donc 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 introductions

L’adhésion automatique est désactivée par défaut, si bien que le bot n’apparaît pas dans les nouveaux salons ni les messages privés issus de nouvelles invitations tant que vous ne rejoignez pas manuellement ; comme OpenClaw ne peut pas savoir au moment de l’invitation s’il s’agit d’un message privé ou d’un groupe, chaque invitation passe d’abord par l’adhésion automatique et la politique de messages privés ne s’applique qu’après que le bot a rejoint et que le salon est classé. Le mode liste avec une liste d’invitations restreint les invitations acceptées et le mode toujours accepte chaque invitation ; la liste d’invitations n’accepte qu’un identifiant de salon littéral, dans sa forme complète ou la forme sans suffixe de la version 12 des salons et suivantes, un alias avec son serveur, ou le joker, et les noms de salons simples sont rejetés parce que les alias se résolvent auprès du serveur plutôt que contre l’état que le salon invitant prétend. L’exemple de la documentation autorise un salon d’exploitation par identifiant et un salon de support par alias avec une mention obligatoire sur le salon d’exploitation. Quand le bot rejoint un salon de groupe autorisé, il publie une introduction ancrée dans le nom, le sujet et jusqu’à cent messages récents lisibles, en n’utilisant que les métadonnées quand la lecture de l’historique échoue et sans jamais inventer d’activité ; les introductions sont activées par défaut, désactivées par la clé d’introduction à l’arrivée ou par compte, jamais envoyées aux salons directs, et déclenchées seulement par une vraie transition d’adhésion plutôt que par une invitation non acceptée, un instantané de démarrage ou une mise à jour de profil.

Cibles, comptes, identifiants, environnement

• Les identifiants d’utilisateur Matrix sont sensibles à la casse, donc chaque champ de liste, d’approbateur et de cible d’approbation doit porter la valeur exacte utilisateur-sur-serveur que Matrix rapporte, et une configuration avec une casse différente doit être corrigée à la main parce que des identifiants distincts par la casse peuvent être des utilisateurs différents ; les champs d’expéditeurs de messages privés et de salons prennent la forme utilisateur, les noms d’affichage étant ignorés sauf si l’interrupteur dangereux de correspondance par nom est activé, les cibles de transfert d’approbation prennent le préfixe utilisateur avec la casse exacte, les clés de liste de salons prennent un identifiant de salon ou un alias, les noms simples étant ignorés sauf interrupteur, et les listes d’invitations prennent un identifiant de salon, un alias ou le joker, les noms simples étant toujours rejetés.
• L’assistant normalise un nom de compte convivial en identifiant de compte, la ponctuation étant échappée en hexadécimal dans les noms de variables d’environnement à portée pour que les comptes n’entrent pas en collision, un trait d’union devenant un code échappé si bien qu’un compte ops-prod obtient son propre préfixe ; les identifiants sont mis en cache dans l’état SQLite partagé de l’extension, si bien que des identifiants en cache font compter Matrix comme configuré même sans jeton dans le fichier de configuration pour la configuration, le doctor et les sondes d’état, et les mises à niveau importent les anciens fichiers d’identifiants par la correction du doctor, vérifient les lignes et archivent les fichiers.
• Les variables d’environnement adossées à la configuration couvrent le serveur, le jeton d’accès, l’identifiant d’utilisateur, le mot de passe, l’identifiant et le nom d’appareil, sans préfixe pour le compte par défaut et avec le jeton de compte inséré pour les comptes nommés, la variable de serveur ne peut pas venir d’un fichier d’environnement d’espace de travail, et la clé de récupération n’est jamais lue depuis l’environnement par OpenClaw lui-même, la ligne de commande ne suggérant qu’une variable de shell pour la transmettre ; la base pratique active le canal avec un jeton et le chiffrement, une politique d’appairage avec une portée de session par salon et les réponses en fil désactivées, une politique de groupe en liste avec un expéditeur administrateur et un salon à mention obligatoire, une liste d’invitations, les réponses en fil entrantes, le mode de réponse désactivé et la diffusion partielle.

OpenClaw sur Matrix est le billet du canal auquel cette configuration appartient, et Le chiffrement Matrix dans OpenClaw l’amorçage du chiffrement que l’assistant peut lancer.

Les invitations avant la politique

La règle d’adhésion automatique est celle à retenir : une politique d’appairage ne fait rien pour un bot qui n’a jamais rejoint, parce que l’invitation a été refusée à la porte. Le contrôle d’accès Matrix d’OpenClaw couvre les politiques de salons et de messages privés qui s’appliquent une fois à l’intérieur, et Connecter votre premier canal en cinq minutes le parcours d’un canal sans serveur à choisir.

Sur Diali

Matrix figure dans la liste des canaux connectables de Diali, aux côtés de WhatsApp, Telegram, Discord, Slack, Mattermost, des SMS et de la voix : le compte sur le serveur d’accueil et la liste d’autorisation des salons sont à vous, la passerelle est à nous. OpenClaw hébergé sur Diali est l’assistant et La sécurité chez Diali décrit la frontière qui s’applique à chaque canal connecté.

• Jeton ou mot de passe ; le mot de passe frappe et met en cache un jeton.
• L’adhésion automatique est désactivée ; les invitations la traversent avant toute politique de messages privés.
• Les identifiants d’utilisateur sont sensibles à la casse dans chaque liste.