Intégration Olvid pour Gladys Assistant
Discutez avec votre maison depuis Olvid, la messagerie chiffrée de bout en bout.
Publiée par prohand
- Messagerie
- Version 1.0.3
- Nécessite Gladys >=4.86.0
- ★ 0
Cette intégration ajoute Olvid comme canal de discussion dans Gladys, exactement comme l'intégration Telegram : vous posez une question à votre maison depuis Olvid, Gladys répond dans la conversation, et vos scènes peuvent vous envoyer des notifications par ce même canal — le tout chiffré de bout en bout, sans annuaire d'entreprise, avec un profil Olvid particulier.
Comment ça marche
Olvid n'a pas d'API bot dans le cloud : il n'existe pas d'équivalent du « BotFather » de Telegram. Un bot Olvid est constitué de deux moitiés :
- le démon Olvid (
olvid/bot-daemon) : une application Olvid complète, qui embarque le moteur cryptographique et héberge votre profil. Elle expose une API gRPC ; - le bot : cette intégration. Elle pilote le démon, relaie les messages vers Gladys et renvoie les réponses.
Gladys fait tourner le démon pour vous : il est déclaré dans le manifeste de
l'intégration, donc le superviseur de Gladys le lance dans son propre conteneur,
sur le réseau privé de l'intégration. Vous n'avez ni fichier docker-compose à
écrire, ni ligne de commande à taper, ni clé à recopier.
Vos messages ne transitent par aucun service tiers ajouté : le démon est un client Olvid comme votre téléphone, et son API gRPC n'est publiée sur aucun port — seule l'intégration peut lui parler.
1. Installer l'intégration
Installez l'intégration Olvid depuis le magasin de Gladys. L'écran
d'installation vous indique ce qu'elle va lancer en plus d'elle-même
(olvid/bot-daemon, sa limite mémoire, et le fait qu'aucun port n'est publié) :
c'est le contrat que vous acceptez.
Au premier démarrage, sans rien remplir, l'intégration :
- génère la clé admin du démon (vous ne la voyez ni ne la saisissez jamais) et démarre le conteneur du démon ;
- crée un profil Olvid particulier, puisque le démon est vide ;
- se crée sa propre clé client, limitée à ce profil (la clé admin ne sert qu'à ça) ;
- active l'acceptation automatique des invitations reçues.
Le démarrage du démon prend quelques dizaines de secondes la première fois (téléchargement de l'image comprise) : le statut de l'intégration passe de « Démarrage du démon Olvid… » à connecté tout seul. Cliquez sur Tester la connexion pour le vérifier : Gladys répond avec la version du démon et le nom du profil.
Vous pouvez ensuite ajuster, si vous le souhaitez :
| Champ | Valeur |
|---|---|
| Prénom / nom | le nom affiché à vos contacts (« Gladys Assistant ») |
| Numéro du profil | 0 (Gladys prend le premier profil, ou en crée un) |
Votre identité Olvid (profil, contacts, messages) vit dans le volume du conteneur du démon, géré par Gladys avec les données de l'intégration. Désinstaller l'intégration détruit ce profil : vos contacts devront vous réinviter. Pensez-y avant de désinstaller, et sauvegardez les données de votre Gladys comme d'habitude.
2. Ajouter Gladys à vos contacts Olvid
C'est le parcours normal d'un particulier sur Olvid : une invitation, puis un code à 4 chiffres échangé entre les deux appareils. Olvid n'automatise jamais cette étape — c'est elle qui garantit que vous parlez bien à votre maison.
- cliquez sur Afficher le lien d'invitation : Gladys affiche un lien
https://invitation.olvid.io/…; - ouvrez ce lien sur le téléphone où est installé Olvid, et envoyez l'invitation ;
- Gladys accepte l'invitation automatiquement (si vous avez désactivé cette option, cliquez sur Accepter les invitations en attente). Votre application affiche alors un code à 4 chiffres et en attend un autre ;
- dans Gladys, cliquez sur Invitations en cours : le code à saisir dans Olvid y est affiché. Recopiez-le dans l'application ;
- saisissez le code affiché par Olvid dans l'action Valider une invitation de Gladys.
Une fois l'échange terminé, « Gladys Assistant » apparaît dans vos contacts Olvid.
3. Lier votre compte Olvid à votre utilisateur Gladys
Être en contact ne suffit pas : Gladys doit savoir quel utilisateur parle, puisqu'un message reçu commande la maison avec ses droits.
- dans Gladys, sur la page de l'intégration Olvid, cliquez sur Lier mon compte : un code court s'affiche (valable 15 minutes) ;
- envoyez ce code à Gladys dans la discussion Olvid ;
- Gladys répond « Compte lié à … ». C'est terminé.
Tant qu'un contact n'est pas lié, Gladys ne transmet rien à son cerveau : elle répond simplement la marche à suivre. Vous pouvez révoquer un lien à tout moment depuis la même page.
Utilisation
- posez vos questions en langage naturel : « quelle est la température du salon ? », « allume la lumière du bureau » ;
- les scènes qui envoient un message peuvent choisir le canal Olvid ;
- les images envoyées par Gladys (photo de caméra) arrivent en pièce jointe ;
- les réponses longues sont découpées en plusieurs messages.
Les discussions de groupe sont volontairement ignorées : un message reçu parle avec les droits de l'utilisateur lié, ce qui n'a de sens qu'en tête-à-tête.
Utiliser votre propre démon (avancé)
Si vous faites déjà tourner un démon Olvid — parce que vous l'utilisez pour d'autres bots, ou que vous voulez maîtriser sa version et ses sauvegardes — passez le champ Démon Olvid sur « Mon propre démon », puis renseignez :
| Champ | Valeur |
|---|---|
| URL du démon Olvid | http://olvid-daemon:50051 |
| Clé client admin | la valeur de OLVID_ADMIN_CLIENT_KEY_GLADYS |
Gladys arrête alors le démon qu'elle gérait, pour ne pas faire tourner deux clients Olvid en parallèle. Le démon doit être joignable depuis le conteneur de l'intégration : partagez un réseau Docker (le conteneur est alors joignable par son nom), ou publiez le port 50051 et utilisez l'adresse IP de la machine.
Un docker-compose.yml minimal pour ce cas :
services:
olvid-daemon:
image: olvid/bot-daemon:2.0.1
container_name: olvid-daemon
restart: unless-stopped
environment:
# Une valeur longue et aléatoire (openssl rand -hex 32) : c'est la clé
# que vous collerez dans Gladys. Elle donne un contrôle total sur le démon.
- OLVID_ADMIN_CLIENT_KEY_GLADYS=changez-moi-par-une-valeur-aleatoire
volumes:
- ./daemon-data:/daemon/data
Dans ce mode, l'identité Olvid est dans votre dossier
./daemon-data: c'est à vous de le sauvegarder.
Dépannage
| Symptôme | Cause probable |
|---|---|
| « Démarrage du démon Olvid… » qui persiste | Le téléchargement de l'image est encore en cours, ou il a échoué : regardez les logs de l'intégration. |
| « Le conteneur du démon Olvid s'est arrêté » | Le démon a quitté au démarrage : ses propres logs, dans Gladys, en donnent la raison. |
| « Démon Olvid injoignable » | Le démon n'a pas fini de démarrer (l'intégration réessaie toute seule). En mode « mon propre démon » : URL ou réseau Docker. |
unauthenticated au test de connexion | Mode « mon propre démon » : la clé client admin ne correspond pas à celle du conteneur du démon. |
| L'invitation reste bloquée | Le code à 4 chiffres n'a pas été échangé des deux côtés (actions « Invitations » et « Valider »). |
| « Votre compte Olvid n'est pas encore lié » | Le code de liaison n'a pas été envoyé, ou il a expiré (15 minutes). |
| Rien n'arrive après un redémarrage | Les messages reçus hors ligne sont rejoués au démarrage ; vérifiez les logs de l'intégration. |
Les logs de l'intégration (LOG_LEVEL=debug pour le détail) indiquent chaque
étape : provisionnement du profil, invitations, messages reçus.
Paramètres de configuration
Voici les paramètres demandés par Olvid dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Comment ça marche | section | Non | Olvid n'a pas d'API bot dans le cloud : les messages passent par un démon Olvid qui héberge votre profil Olvid particulier. Gladys fait tourner ce démon pour vous, dans son propre conteneur, avec une clé qu'elle génère — rien à installer à la main. Utilisez les boutons ci-dessous pour présenter Gladys à votre application Olvid, puis liez votre compte. |
| Démon Olvid | select | Non | Géré par Gladys : le démon tourne dans un conteneur que Gladys démarre, maintient et sécurise avec une clé générée — laissez les deux champs ci-dessous vides. Ne choisissez votre propre démon que si vous en faites déjà tourner un, puis renseignez-les. |
| URL du démon Olvid | string | Non | Uniquement pour votre propre démon : point d'accès gRPC, joignable depuis ce conteneur. http:// en clair, https:// si le démon expose du TLS. |
| Clé client admin | secret | Non | Uniquement pour votre propre démon : sa valeur OLVID_ADMIN_CLIENT_KEY_*. Gladys s'en sert pour choisir son profil et créer sa propre clé. |
| Numéro du profil Olvid | number | Non | Profil du démon à utiliser. Laissez 0 pour prendre le premier, et en créer un si le démon est vide. |
| Prénom du profil | string | Non | Nom affiché à vos contacts, utilisé quand Gladys crée le profil Olvid. |
| Nom du profil | string | Non | |
| Accepter automatiquement les invitations | boolean | Non | Gladys accepte les invitations reçues, il ne vous reste que le code à 4 chiffres à échanger. Les invitations de groupe ne sont jamais acceptées. |
Comment installer Olvid dans Gladys
- Dans Gladys, ouvrez Intégrations : Olvid apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/prohand/gladys-olvid:1.0.3), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/prohand/gladys-olvid.
Olvid nécessite Gladys >=4.86.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Olvid est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par prohand, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation