ego (lite) n’est qu’un navigateur ; ego est votre agent personnel sur tous vos appareils.
Rejoindre la liste d'attente
Télécharger pour Mac
Français
EnglishFrançaisDeutsch简体中文繁體中文日本語한국어РусскийPortuguêsEspañolItalianoहिन्दी
Solutions
DocumentationEntrepriseNotes de mise à jourBlog

Utiliser ego (lite) avec votre propre Agent Harness

Connectez votre propre Agent Harness à ego (lite). Vérifiez où s’exécutent les commandes, accordez l’exécution locale uniquement si nécessaire, chargez ego-browser et menez une tâche dans le navigateur jusqu’au bout.

llms.txt

Séquence d’exemple : ce guide utilise des enregistrements OpenClaw pour illustrer un parcours de connexion avec un Agent Harness. Votre Harness peut présenter des menus, des commandes et des noms de permissions différents.

Votre propre Agent Harness peut piloter ego (lite) tant qu’il peut exécuter ego-browser sur l’ordinateur où ego (lite) est installé. Identifiez d’abord si vous utilisez une interface Desktop ou un TUI afin de savoir où chercher les réglages. Déterminez ensuite où le Harness exécute les commandes. Cette seconde question décide si un accès en exécution locale est nécessaire.

Traitez la vidéo comme un parcours Desktop possible, et non comme une interface de Harness universelle.

Avant de commencer

Installez ego (lite), terminez la configuration initiale et assurez-vous que votre Harness peut exécuter des commandes Shell.

  1. Téléchargez le fichier DMG et ouvrez-le
  2. Suivez les instructions et double-cliquez sur l'icône d'ego (lite) pour l'installer
  3. Ouvrez ego (lite) et terminez la configuration initiale
    1. Ouvrez votre Harness dans son interface Desktop ou son TUI
    1. Confirmez que le Harness peut exécuter des commandes sur l’ordinateur où ego (lite) est installé

ego (lite) installe la Skill partagée ego-browser dans ~/.agents/skills/. Si votre Harness prend en charge les Agent Skills, configurez-le pour analyser ce dossier ou importez la Skill selon la méthode documentée par le Harness.

Après avoir installé ego (lite), quittez complètement l’application Agent puis relancez-la avant de continuer. Cela permet à l’application de recharger la Skill ego-browser nouvellement installée et d’afficher sa commande slash correspondante dans les applications qui prennent en charge les commandes slash de Skill. Fermer uniquement la session ou la fenêtre en cours peut empêcher le rechargement de la Skill.

Desktop et TUI déterminent où se trouvent les réglages

Une application Desktop peut exécuter des commandes directement sur votre ordinateur ou à l’intérieur d’un sandbox. Un TUI peut faire l’un ou l’autre également. Utilisez le type d’interface pour trouver les réglages pertinents, puis inspectez l’environnement d’exécution des commandes. La nécessité de contourner des permissions dépend du fait que l’agent peut exécuter des commandes sur l’ordinateur où ego (lite) est installé.

  • Dans une interface Desktop, cherchez les permissions dans les réglages de session, d’espace de travail, d’agent, d’outil ou de sécurité.
  • Dans un TUI, vérifiez les indicateurs de démarrage, le fichier de configuration, les variables d’environnement ou la ligne d’état de la session.

L’étape suivante détermine quel parcours de permissions s’applique à votre Harness.

Étape 1 : vérifiez où votre Harness exécute les commandes

Demandez d’abord à l’agent d’exécuter cette commande depuis la même session qui effectuera la tâche de navigateur :

command -v ego-browser

Cette commande confirme seulement si la session en cours peut trouver ego-browser. Elle ne prouve pas que les commandes s’exécutent sur l’ordinateur hôte. Utilisez les informations de session du Harness ou la documentation officielle pour identifier l’environnement d’exécution, puis confirmez-le avec le test de connexion réel de l’étape 4.

Choisissez l’étape suivante selon l’environnement d’exécution :

  1. Les commandes s’exécutent directement sur cet ordinateur sans sandbox : ego-browser peut lancer l’ego (lite) installé localement. Il se peut qu’aucun réglage de contournement des permissions n’existe, et vous n’avez pas besoin d’en créer un. Passez à l’étape 3.
  2. L’agent s’exécute à l’intérieur d’un sandbox local : le Harness doit fournir une capacité officielle d’exécution locale, non sandboxée ou de passerelle hôte permettant à l’agent de confier ego-browser à cet ordinateur. Passez à l’étape 2.
  3. L’agent s’exécute dans un conteneur, une machine virtuelle, un serveur distant ou un environnement cloud : le Harness a besoin d’une passerelle hôte capable d’exécuter ego-browser sur cet ordinateur. Sans cette passerelle, installer ou charger la Skill dans l’environnement distant ne suffit pas à contrôler l’application ego (lite) locale.

Si command -v ego-browser ne renvoie aucun chemin, confirmez d’abord que la configuration initiale d’ego (lite) est terminée. Vérifiez ensuite si le Harness utilise un PATH ou un environnement d’exécution différent de celui de votre terminal habituel.

Étape 2 : assurez-vous que l’agent peut s’exécuter hors du sandbox

Avant de continuer, assurez-vous que l’agent peut s’exécuter hors du sandbox et lancer ego-browser sur l’ordinateur où ego (lite) est installé. Si l’agent s’exécute déjà directement sur cet ordinateur sans sandbox, aucune permission supplémentaire n’est nécessaire.

Si le Harness demande une confirmation avant chaque commande, vous pouvez approuver les commandes manuellement ou activer son mode sans approbation pour une session de confiance. Le mode sans approbation réduit seulement les invites de confirmation ; il n’est pas requis pour se connecter à ego (lite).

Exemple Desktop : politique d’approbation

Cet enregistrement montre les réglages Exec Approvals d’OpenClaw. Il illustre seulement comment un Harness Desktop peut gérer les approbations de commandes. Désactiver les invites d’approbation ne prouve pas que l’agent dispose d’un accès à l’exécution locale. Si votre Harness utilise un sandbox, suivez d’abord sa documentation officielle pour activer l’exécution locale ou une passerelle hôte, puis ajustez la politique d’approbation si nécessaire.

Exemple TUI : mode sans approbation

Cet enregistrement montre OpenClaw appliquant son propre préréglage sans approbation avant d’ouvrir le TUI. Il modifie la politique d’approbation d’OpenClaw ; il ne signifie pas qu’un autre Harness peut désormais s’échapper de son sandbox. Ne copiez pas la commande OpenClaw dans un autre Harness à moins que sa documentation ne le prenne en charge. Recherchez séparément la méthode officielle d’exécution locale et le réglage d’approbation fournis par votre Harness.

L’exécution locale élargit ce que l’agent peut atteindre sur votre ordinateur. Le mode sans approbation supprime l’étape de confirmation avant chaque commande. Ces contrôles comportent des risques différents. Ne les activez que pour un Harness, un espace de travail et une tâche en lesquels vous avez confiance. Si le Harness prend en charge une liste d’autorisation de commandes hôte ou une politique plus restreinte, préférez n’accorder l’accès qu’aux commandes requises pour ce parcours.

Étape 3 : charger la Skill ego-browser

Exemple Desktop

L’enregistrement utilise le sélecteur de Skills d’OpenClaw pour charger ego-browser. Dans votre propre Harness Desktop, ouvrez une session d’agent locale capable de Shell et chargez ego-browser depuis son interface Skills ou Tools. La commande exacte affichée dans OpenClaw est propre au produit.

Exemple TUI

Si votre TUI prend en charge les commandes slash de Skill, saisissez /ego-browser, ajoutez un espace, puis poursuivez avec la tâche dans le même message. S’il ne fournit pas de commandes slash, demandez à l’agent de localiser et lire la Skill ego-browser avant de commencer. Un élément de menu /ego-browser absent ne signifie pas en soi que la Skill ne peut pas être utilisée.

Vous pouvez utiliser cette vérification de compatibilité comme première invite :

Déterminez d’abord si votre environnement d’exécution de commandes tourne directement sur cet ordinateur ou à l’intérieur d’un sandbox, d’un conteneur ou d’un environnement distant. S’il utilise un sandbox, confirmez que vous disposez d’une permission ou passerelle officielle permettant d’exécuter des commandes sur cet ordinateur. Ne considérez pas la désactivation des invites d’approbation comme une preuve d’exécution locale.

Ensuite, localisez et lisez la Skill ego-browser. Vérifiez d’abord ~/.agents/skills/ego-browser/SKILL.md. Si vous ne pouvez pas exécuter ego-browser sur cet ordinateur, arrêtez-vous et expliquez quelle permission ou passerelle d’exécution locale manque.

Étape 4 : exécutez un test de connexion simple

Avant d’ouvrir un site sur lequel vous êtes connecté, testez la connexion avec une page publique simple :

Utilisez la Skill ego-browser pour ouvrir https://example.com dans ego (lite), rapportez le titre de la page et laissez la page ouverte.

Le parcours d’exécution locale fonctionne lorsque ego (lite) ouvre un Agent Space, que la page se charge et que le Harness renvoie le titre de la page. Si la page s’ouvre après que vous approuviez la commande manuellement, seule la politique d’approbation reste en jeu ; vous pouvez continuer à approuver les commandes ou utiliser le réglage sans approbation documenté du Harness pour une session de confiance. Si la commande n’atteint jamais cet ordinateur, revenez aux étapes 1 et 2 et vérifiez la permission ou passerelle d’exécution locale.

Étape 5 : laissez votre agent effectuer une tâche de navigateur

Une fois le test de connexion réussi, confiez au Harness une tâche de navigateur réelle. L’enregistrement utilise OpenClaw comme contrôleur d’exemple, mais le parcours ego (lite) visible est le même : l’agent charge la Skill, ouvre un Agent Space, visite la page cible et collecte les informations demandées.

Essayez la même tâche utilisée tout au long de ces guides :

Utilisez la Skill ego-browser pour ouvrir le profil X officiel d’Anthropic et collecter les cinq premiers posts affichés dans le fil Posts.

Si le Harness ne prend pas en charge les commandes slash de Skill, cette instruction en langage naturel suffit dès lors que l’agent peut localiser la Skill et exécuter ego-browser sur l’ordinateur hôte.

Étape 6 : vérifiez le résultat terminé

À la fin de la tâche, confirmez que le Harness a renvoyé les informations demandées et que la page source reste ouverte dans ego (lite). L’enregistrement montre le résultat dans OpenClaw ; votre propre Harness peut présenter la réponse différemment.

Si le site demande une connexion, un CAPTCHA ou une vérification de compte, prenez la main dans le Space d’agent ego (lite) et effectuez-la vous-même. Ne mettez jamais de mots de passe ni de codes de vérification dans l’invite de l’agent.

Résolution des problèmes

Mon Harness n’a pas de contournement des permissions

Cela peut être normal. Si les commandes s’exécutent déjà directement sur votre ordinateur sans sandbox, il n’y a pas de permission de sandbox à contourner. Confirmez que command -v ego-browser renvoie un chemin depuis la session de l’agent, puis vérifiez la connexion à l’étape 4. Si le Harness demande seulement une approbation par commande, vous pouvez approuver chaque commande manuellement au lieu de chercher un réglage de contournement des permissions.

/ego-browser n’apparaît pas

Les commandes slash sont une fonctionnalité d’interface du Harness, pas une exigence d’ego (lite). Demandez à l’agent de lire ~/.agents/skills/ego-browser/SKILL.md, ou configurez le Harness pour analyser ~/.agents/skills/ via sa méthode d’import de Skill prise en charge.

ego-browser est introuvable

Terminez la configuration initiale d’ego (lite), redémarrez le Harness, puis relancez command -v ego-browser depuis la même session de l’agent. Si la commande fonctionne dans votre terminal habituel mais pas dans le Harness, comparez leurs PATH et environnements d’exécution.

L’agent continue de demander une approbation

Cela signifie seulement que le Harness applique encore sa politique d’approbation ; cela ne prouve pas que l’agent est coincé dans un sandbox. Si ego (lite) s’ouvre après approbation manuelle, continuez à approuver les commandes ou utilisez le réglage sans approbation documenté du produit pour une session de confiance. Si la commande ne parvient toujours pas à l’hôte après approbation, vérifiez la permission ou passerelle d’exécution locale. Ne copiez pas de commandes ni d’indicateurs d’un autre produit.

Le Harness s’exécute dans Docker, en SSH ou dans le cloud

L’environnement d’exécution distant ne peut pas contrôler une installation ego (lite) locale à moins que le Harness ne fournisse une passerelle d’exécution locale. Exécutez le Harness localement, configurez sa passerelle prise en charge, ou installez et exécutez un environnement de navigateur compatible sur la même machine que l’environnement d’exécution de l’agent.

La Skill se charge mais ego (lite) ne s’ouvre pas

Confirmez que l’agent exécute ego-browser sur l’ordinateur où ego (lite) est installé. Charger la Skill donne des instructions à l’agent ; cela ne déplace pas l’exécution des commandes depuis un sandbox ou une machine distante vers votre ordinateur.

Pour aller plus loin