Comptes et serveurs Matrix dans OpenClaw

Un déploiement Matrix se définit par deux choses : avec quels comptes la passerelle se connecte, et comment elle atteint leurs serveurs. La documentation d’OpenClaw rassemble les opérations au niveau du compte, profil, réparation des salons directs, disposition multi-comptes, serveurs privés et proxys, avec les formes de cibles sur lesquelles toutes les autres fonctions Matrix reposent. Les voici, avec les règles qui décident quel compte une commande désigne et quel salon une cible nomme.

Profils et salons directs

• Une commande de profil définit le nom d’affichage et l’avatar en un seul appel ; Matrix accepte directement les URL d’avatar du dépôt de contenu, et une URL HTTP est d’abord envoyée puis l’URL de contenu résolue est stockée dans le réglage d’avatar, globalement ou par compte.
• Si l’état des messages privés dérive, le compte peut se retrouver avec des correspondances directes périmées pointant vers d’anciens salons solitaires ; une commande d’inspection montre la correspondance pour un correspondant et une commande de réparation la corrige, toutes deux acceptant une option de compte.
• La réparation préfère un message privé strict à deux déjà mis en correspondance, retombe sur tout message privé strict actuellement rejoint avec cet utilisateur, et crée un nouveau salon direct en réécrivant la correspondance quand aucun message privé sain n’existe ; elle ne supprime jamais les anciens salons, elle choisit le sain pour que les envois, avis de vérification et autres flux directs futurs visent le bon salon.
• Dans une disposition multi-comptes, les valeurs Matrix de premier niveau servent de défauts aux comptes nommés sauf surcharge, une entrée de salon héritée peut être limitée à un compte par un champ de compte, et les entrées sans ce champ sont partagées.

Les identifiants de salons Matrix sont sensibles à la casse.

Quel compte une commande désigne

Un réglage de compte par défaut choisit le compte nommé que le routage implicite, les sondes et les commandes CLI préfèrent ; un compte littéralement nommé default est utilisé implicitement même sans le réglage ; avec plusieurs comptes nommés et aucun défaut, la CLI refuse de deviner et demande le réglage ou une option de compte ; et le bloc de premier niveau n’est traité comme défaut implicite que quand son authentification est complète, un serveur plus un jeton d’accès ou un serveur plus un identifiant d’utilisateur et un mot de passe, tandis que les comptes nommés restent découvrables par un serveur et un identifiant d’utilisateur une fois que des identifiants en cache couvrent l’authentification. Quand une réparation ou une configuration promeut une configuration à compte unique en multi-comptes, un compte nommé existant est préservé, seules les clés d’authentification et d’amorçage passent dans le compte promu, et les clés partagées de politique de livraison restent au premier niveau.

Joignabilité et cibles

• Les serveurs privés et internes sont bloqués par défaut pour la protection contre les SSRF ; une adhésion au réseau privé par compte autorise localhost, les adresses de réseau local ou Tailscale et les noms d’hôtes internes, aussi réglable depuis la commande d’ajout de compte, tandis que les serveurs publics en clair restent bloqués et que HTTPS est préféré dès que possible.
• Un réglage de proxy sortant explicite route le trafic Matrix par un proxy HTTP ou HTTPS, surchargeable par compte nommé, et le même proxy sert au trafic d’exécution et aux sondes d’état des comptes.
• Les cibles prennent trois formes partout où OpenClaw demande un salon ou un utilisateur : les utilisateurs par un identifiant Matrix avec des préfixes facultatifs d’utilisateur ou d’utilisateur Matrix, les salons par un identifiant de salon avec des préfixes facultatifs, les versions de salons récentes n’ayant pas de suffixe de serveur, et les alias avec des préfixes de canal facultatifs. Les identifiants de salons doivent garder leur casse exacte, puisque les clés de session internes sont en minuscules canoniques et ne sont pas une source pour les identifiants de livraison ; les recherches d’utilisateurs interrogent l’annuaire d’utilisateurs du serveur, les recherches de salons acceptent directement les identifiants et les alias, la recherche par nom de salon rejoint est au mieux et ne s’applique aux listes d’autorisation d’exécution que sous l’indicateur dangereux de correspondance par nom, et un nom de salon irrésoluble est ignoré.

OpenClaw sur Matrix est le billet du canal que celui-ci approfondit, et Chiffrement et vérification Matrix dans OpenClaw la page compagne dont toutes les commandes acceptent la même option de compte.

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. 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.

Pourquoi refuser de deviner

Refuser de choisir un compte quand plusieurs existent relève du même instinct que la règle de sensibilité à la casse : une commande Matrix qui atterrit sur le mauvais compte ou le mauvais salon est pire qu’une commande qui s’arrête et demande. OpenClaw hébergé sur Diali est l’assistant et Le routage des canaux d’OpenClaw le routage général que ces cibles alimentent.

• Les valeurs de premier niveau sont des défauts ; les comptes surchargent.
• Les serveurs privés exigent une adhésion ; le clair reste bloqué.
• Casse exacte des identifiants de salons ; la CLI ne devine jamais un compte.