Keural Duo

Duo est un agent permanent que l'application de bureau installe sur cet ordinateur (ou sur un DGX Spark connecté). Il s'exécute dans un sandbox isolé, vous discutez avec lui depuis Duo dans la barre latérale ou via Telegram, et il exécute les routines que vous avez enregistrées. Il repose sur NVIDIA NemoClaw et OpenClaw.

InstallerCopier le lien vers la section

Dans Paramètres → Duo → Environnement d'exécution, choisissez un modèle, puis cliquez sur Installer sur la ligne de l'emplacement où vous voulez l'exécuter. Si aucun modèle n'est choisi ou si le disque manque d'espace, le bouton Installer est désactivé.

Emplacement d'exécution et prérequisCopier le lien vers la section

Duo nécessite au moins 20 Go d'espace disque, et 40 Go ou plus sont recommandés. S'il manque de l'espace, le bouton Installer est verrouillé et le message « {need} Go nécessaires · {free} Go disponibles » s'affiche.

ModèleCopier le lien vers la section

Après l'installation, changez de modèle sur la ligne Modèle. Au sein d'un même type, le changement se fait immédiatement avec « Changer ». Si vous passez d'un type à un autre (local, cloud ou passerelle), réinstallez. La réinstallation conserve les routines. Pour déplacer Duo vers un autre emplacement, supprimez-le puis installez-le au nouvel endroit.

Étapes d'installationCopier le lien vers la section

Les étapes s'enchaînent dans cet ordre : vérification de cet appareil → préparation de l'environnement de conteneurs → installation de NemoClaw → démarrage du modèle (pour le cloud et la passerelle, préparation de l'accès au modèle) → création du sandbox → configuration de Duo → vérification du fonctionnement. L'étape en cours apparaît sur le bouton et sur la carte de progression. Si le message « Cela prend un peu de temps. Gardez l'application ouverte. » s'affiche, ne fermez pas l'application.

Si l'installation s'arrête, vérifiez la cause dans Quand l'installation échoue, à partir du message affiché à l'écran.

Duo d'un autre compte ou espace de travailCopier le lien vers la section

Il ne peut y avoir qu'un seul Duo par appareil, et il appartient au compte et à l'espace de travail où il a été installé. Si vous vous connectez avec un autre compte ou si vous changez d'espace de travail, le Duo des Paramètres s'affiche comme « Non installé », et le Duo de la barre latérale ainsi que Mate & Morph sont masqués. Dans cet état, si vous cliquez sur Installer, une confirmation indique que le Duo existant, ses conversations et ses routines seront supprimés. Si vous cliquez sur Nouvelle installation, le Duo existant est supprimé et un nouveau est créé. Lorsque vous revenez sur le compte ou l'espace de travail d'origine, ce Duo réapparaît.

Si un Duo installé précédemment subsiste, il est nettoyé avant l'installation. Si le nettoyage échoue, le message « Impossible de supprimer l'ancien Duo. Réinstallez-le. » s'affiche.

Quand l'installation échoueCopier le lien vers la section

Si l'installation s'arrête, Paramètres → Duo affiche un message d'erreur. Vérifiez aussi le code entre parenthèses, s'il y en a un. Une fois la cause résolue, cliquez de nouveau sur Installer.

Si le problème persiste, contactez l'assistance dans Paramètres → Assistance. Indiquez le message affiché à l'écran, le code entre parenthèses et le type d'appareil (macOS, Windows ou Spark).

Écran Paramètres → DuoCopier le lien vers la section

Pendant l'installation, le changement de modèle, l'application des changements aux applications de chat ou la suppression, les autres sections sont verrouillées. Une boîte de confirmation du système d'exploitation n'apparaît que lorsque vous activez l'utilisation de l'ordinateur ou élargissez ses règles.

ConversationCopier le lien vers la section

Cliquez sur Duo dans la barre latérale. (Il n'est pas affiché en mode Code.) Les messages envoyés pendant une coupure de connexion sont affichés sous la forme « {n} en attente d'envoi » et sont transmis au rétablissement de la connexion. Si vous envoyez /new dans la zone de saisie, l'application vous demande si vous voulez démarrer une nouvelle conversation.

Lorsque vous activez Infos sur Duo en haut, les cartes suivantes s'affichent dans le panneau latéral.

Cliquez sur Tâches en arrière-plan pour voir la liste des sous-agents en cours d'exécution lorsque Duo en lance.

Mémoire de conversationCopier le lien vers la section

Dans Paramètres → Duo → Mémoire de conversation, le « Contexte utilisé » s'affiche en nombre de jetons et en pourcentage. Utilisez Compresser pour raccourcir la conversation, ou Nouvelle pour ouvrir une nouvelle conversation. La conversation en cours est conservée. Si Duo travaille, ces actions sont possibles une fois sa tâche terminée. Lorsque la conversation est trop longue pour être traitée par le modèle, le message « La conversation est trop longue pour que le modèle la traite, Duo n'a pas pu répondre. » s'affiche. Dans ce cas, compressez la conversation ou commencez-en une nouvelle.

RoutinesCopier le lien vers la section

Si vous dites à Duo quelque chose comme « Tous les matins à 9 h, fais … », la carte Créer cette routine ? (Tâche · Horaire · Emplacement) s'affiche. Cliquez sur Créer la routine pour l'enregistrer. Les modifications et suppressions sont aussi confirmées avec la même carte.

Sur la carte Routines du panneau d'informations de Duo, vous pouvez activer et désactiver les routines. Avec Plus, choisissez Exécuter maintenant ou Supprimer. Chaque ligne affiche la prochaine exécution et l'état (Envoyée · Manquée · Échouée · Suspendue · Expirée). Les résultats des routines sont transmis à la conversation Duo ou à Telegram, avec une notification de bureau (Exécuter maintenant n'affiche pas de notification). Les routines ne s'exécutent que lorsque l'application est ouverte.

Applications de chat (Telegram)Copier le lien vers la section

Suivez les étapes dans Paramètres → Duo → Applications de chat → Telegram → Connecter.

1. Dans Telegram, ouvrez @BotFather, envoyez /newbot, puis choisissez le nom et le nom d'utilisateur de votre bot.
2. Collez le jeton du bot fourni par BotFather, puis cliquez sur Vérifier. Ne communiquez pas ce jeton : quiconque le possède peut contrôler le bot.
3. Scannez le QR code avec votre téléphone pour ouvrir le bot, puis cliquez sur Démarrer. Sans réponse, envoyez au bot le code affiché à l'écran.
4. Lorsque le message « Seul {name} peut discuter avec Duo en message privé. » s'affiche, cliquez sur Ajouter, puis sur Appliquer.

Lors de l'application, Duo redémarre (les conversations et les fichiers sont conservés). Ensuite, les messages que vous envoyez depuis votre téléphone apparaissent dans la conversation Duo avec la mention « Envoyé depuis Telegram ». Seule la personne connectée peut discuter avec Duo en message privé. Pour déconnecter, cliquez sur Déconnecter, puis sur Appliquer. Lorsque Telegram est connecté, les approbations de routines arrivent aussi sur Telegram.

Un jeton de bot ne peut être utilisé que sur un seul appareil (Duo) par compte. Pour l'utiliser sur un autre appareil, déconnectez d'abord l'appareil existant, puis enregistrez de nouveau le jeton.

Les approbations d'actions dans les applications se font uniquement dans la fenêtre de l'application Keural, même pour les conversations démarrées depuis Telegram.

ConnexionsCopier le lien vers la section

Configurez-les dans Paramètres → Duo → Connexions.

Utilisation de l'ordinateurCopier le lien vers la section

Dans Paramètres → Duo → Utilisation de l'ordinateur, activez Autoriser Duo à utiliser cet ordinateur. Duo peut alors utiliser les applications de cet ordinateur, lire les dossiers que vous indiquez et créer des routines. Lorsque vous l'activez, Duo redémarre pendant environ une minute.

Même avec Agir sans demander ou Toujours autoriser, les étapes sensibles comme envoyer, supprimer, écraser, payer, soumettre, se connecter, publier et annuler, ainsi que les touches comme Entrée, Retour arrière et ⌘Q, demandent toujours une confirmation préalable.

Lorsque Duo attend votre approbation, « Duo attend votre approbation » s'affiche au-dessus de la zone de saisie. Cliquez sur Examiner pour ouvrir la fenêtre d'approbation, puis choisissez Refuser · Autoriser une fois · Toujours autoriser. Les approbations ne peuvent se faire que dans cette fenêtre.

Duo n'ouvre sans approbation que les liens des résultats de recherche. Pour les adresses qu'il a lui-même saisies ou modifiées, la fenêtre d'approbation affiche l'adresse complète et demande confirmation.

Mate & MorphCopier le lien vers la section

Mate & Morph est le personnage de bureau de Duo. Activez Paramètres → Duo → Utilisation de l'ordinateur → Mate & Morph → Afficher sur le bureau, puis choisissez le Personnage (Mate · Morph · Les deux) et la Taille (Petit · Moyen · Grand).

• Il s'affiche lorsque Duo est en cours d'exécution et que la conversation est prête. Il est masqué si vous changez de compte ou d'espace de travail, ou si votre forfait ne permet pas d'utiliser Duo.
• Un clic sur le personnage ouvre le champ de saisie, et un double-clic ouvre l'application. L'état (En attente · En cours · Terminé · Bloqué · Votre réponse est nécessaire · En attente d'approbation) et la raison du dernier échec de réponse s'affichent à côté du personnage.
• Menu contextuel (clic droit) : Masquer · Marquer comme lu · Ouvrir Duo · Paramètres de Duo. Le menu de la barre de menus (zone de notification) propose aussi Afficher/Masquer Mate & Morph.

WindowsCopier le lien vers la section

Sous Windows, Duo s'exécute dans une distribution WSL. Il prend en charge les conversations, les routines, Telegram, les approbations, Mate & Morph et l'utilisation de l'ordinateur de la même manière que sous macOS. Certaines applications et fenêtres sensibles, comme les champs de mot de passe, les demandes UAC et les terminaux, ne sont pas contrôlées par Duo : vous devez les utiliser directement.

Dans Paramètres → Duo → Nouvelles fonctions (ordinateur Windows), vérifiez la connexion de Duo, puis consultez les Dossiers partagés (Duo ne lit que les dossiers que vous choisissez), l'Accès aux applications et les Tâches récentes. Sous Windows, vous pouvez aussi utiliser l'Installation de logiciels (uniquement avec un identifiant de paquet exact) et la Connexion Wi‑Fi (uniquement avec les profils enregistrés). Envoyer, supprimer, écraser, installer et modifier le réseau demandent toujours une confirmation préalable.

SupprimerCopier le lien vers la section

Dans Paramètres → Duo → Environnement d'exécution, cliquez sur Supprimer sur la ligne de l'emplacement où Duo est installé, puis confirmez avec Supprimer dans la fenêtre de confirmation. Le sandbox, l'historique des conversations, les routines et les fichiers de travail sont supprimés. Sous macOS, la machine virtuelle de conteneurs réservée à Duo est aussi supprimée. Un Duo installé sur un DGX Spark ne peut être supprimé que si le Spark est connecté.

Messages fréquentsCopier le lien vers la section

Détails techniques pour l'équipe ITCopier le lien vers la section

PrérequisCopier le lien vers la section

Sous Windows, l'installation écrit networkingMode=nat dans la section [wsl2] de %USERPROFILE%\.wslconfig. Sur les PC qui utilisent la mise en réseau miroir (mirrored), Duo n'est pas installé.

Emplacements d'installationCopier le lien vers la section

TéléchargementsCopier le lien vers la section

Autorisez les adresses suivantes dans le pare-feu ou le proxy. Les fichiers téléchargés ont une version figée et sont vérifiés par SHA-256.

Si vous utilisez la recherche web ou la connexion GitHub, les adresses api.tavily.com, api.search.brave.com, api.github.com et api.githubcopilot.com doivent aussi être autorisées.

Réseau et portsCopier le lien vers la section

Si le pare-feu ufw est activé sur le Spark, l'installation ouvre deux ports (celui de la passerelle et celui du relais). Le mot de passe du compte Spark est alors saisi une fois.

Le sandbox n'accède pas directement à Internet. La recherche web et la lecture des pages sont traitées par l'application, et GitHub est connecté en lecture seule.

Adresses des modèlesCopier le lien vers la section

L'adresse de la passerelle peut être quelconque si elle utilise https. Avec http, seules les adresses IP privées et les noms internes (.local, .lan, .internal, .intranet, .home.arpa et les noms sans point) sont acceptés. Les adresses localhost et celles contenant user:pass@ ne sont pas acceptées.

TelegramCopier le lien vers la section

• Le jeton du bot s'obtient avec /newbot auprès de BotFather. Son format est nombre:alphanumérique.
• Lorsque l'application génère le code de connexion, ouvrez le bot sur votre téléphone dans les 10 minutes et envoyez le premier message dans les 5 minutes. Le compte qui envoie ce premier message est autorisé.
• Duo ne répond pas dans les conversations de groupe.

RoutinesCopier le lien vers la section

Règles d'ajout de dossiersCopier le lien vers la section

Les dossiers suivants ne peuvent pas être ajoutés.

Autorisations de l'utilisation de l'ordinateurCopier le lien vers la section

Les boutons tels qu'envoyer, supprimer, payer, acheter, soumettre, se connecter, virer, publier et annuler, ainsi que les touches comme Entrée, Suppr, fermer une fenêtre ou quitter une application, sont considérés comme des étapes sensibles et font toujours l'objet d'une demande de confirmation.

Ce qui est supprimé lors de la suppressionCopier le lien vers la section

Lorsque vous cliquez sur Supprimer, sont supprimés : le sandbox, l'historique des conversations Duo, les routines, les connexions Telegram, GitHub et recherche, ainsi que le jeton du modèle cloud. Si aucun autre Duo n'est présent sur cet appareil, macOS supprime aussi ~/.keural-runtime/ et les éléments de démarrage automatique. Les réglages de Mate & Morph et les enregistrements de connexion au Spark sont conservés.