2026 Canal Matrix OpenClaw : plugin matrix-js-sdk, configuration minimale, Mac cloud
Matrix n'est pas un simple webhook : synchronisation longue durée, jetons, chiffrement optionnel — tout diffère de Slack ou Discord. Ce guide couvre l'intégration matrix-js-sdk, les prérequis plugin, l'ordre homeserver → ACL salon, la supervision sur Mac cloud et un tableau symptômes. À lire avec l'article DNS Docker du blog VPSMAC pour éviter les mauvais niveaux d'abstraction.
1. Frictions
Si la boucle de sync s'arrête, silence prolongé. Jetons personnels pour les bots : audit et rotation cassés. E2EE sans confiance d'appareil : symptômes ressemblant à un plugin mort. Contrairement aux webhooks, membres et ACL déterminent la délivrance. Modèle vert mais Matrix rouge : inspecter file de sync et droits avant le LLM.
Avec interception TLS, aligner magasins de certificats et exceptions proxy sur le processus OpenClaw. Pour la fédération, valider ports pare-feu et IP de sortie du fournisseur Mac cloud.
2. Prérequis
Plugins et registre centralisent les capacités ; Matrix passe par le SDK officiel. Version Node respectée, releases épinglées, sauvegarde ~/.openclaw. Même environnement pour HTTPS_PROXY et NO_PROXY que le service. Sur Mac cloud : launchd et rotation des logs ; staging sépare latence modèle et latence sync. Ne pas fusionner mises à jour majeures avec changements SecretRef documentés ailleurs.
Matrix génère plus d'état par message qu'un webhook — volume de logs et rétention à dimensionner. Mise à l'échelle : éviter le même jeton sur plusieurs instances concurrentes.
3. Tableau
| Axe | Matrix SDK | Webhook |
|---|---|---|
| Lien | Sync longue | Requête/abonnement |
| Secrets | Jeton+device | URL/OAuth |
| Ops | Reconnect, lag | 429 |
4. Cinq étapes
Prouver réseau et identité avant les prompts ; critère de succès d'une ligne par étape pour l'astreinte.
- Installer plugin version figée
- URL HTTPS homeserver
- Jeton bot dans secrets
- Salon minimal texte brut
openclaw doctor, logs, politique restart launchd
curl hôte vs conteneur.5. Indicateurs
- Plafond de lag sync mesuré en E2E
- 429 sur IP sortante partagée : sharder ou jitter
- Rotation logs contre disque plein
- Burn-in 24h en staging
- Expiration jetons dans le runbook
- Faible RAM : sync vs inférence en compétition
- Matrice de routage pour éviter collisions Slack/Matrix
6. FAQ
Avec Slack ? Secrets et labels séparés ; un canal modifié à la fois.
| Symptôme | D'abord | Ensuite |
|---|---|---|
| Pas d'inbound | adhésion, sync | FW, proxy, TLS |
| Échec envoi | ACL, débit | règles modèle |
| Flaky | restart, RAM, disque | maintenance serveur |
Rollback : archive config ; autres canaux vivants sans Matrix.
Tableaux de bord : séparer latences sync et modèle. Windows ou conteneurs excessifs ajoutent friction. Nœud Mac cloud dédié VPSMAC : SSH, cohérent avec les autres guides OpenClaw ; le déploiement cinq minutes referme la boucle.