Installer et dépanner Kimi WebBridge

Kimi WebBridge s’appelle désormais Kimi Browser Extension. Si le panneau latéral s’ouvre alors que l’agent local signale que le navigateur est hors ligne, vérifiez séparément l’extension, le service et l’agent. Lisez d’abord le message original de l’outil. Un indicateur d’état ne permet pas à lui seul de situer la panne.

Kimi Browser Extension

Un membre de r/kimi a expliqué que Claw signalait WebBridge hors ligne alors que l’extension semblait active. Ce symptôme justifie de vérifier chaque liaison séparément. r/kimi

À retenir

Kimi documente Chrome et Edge sur macOS ou Windows. Installez l’extension dans le profil qui exécutera la tâche.
Le panneau latéral et le pilotage par un agent local se configurent séparément. Un panneau actif ne confirme qu’une partie du parcours.
Connection refused renvoie au service local. extension_not_connected renvoie à la liaison entre ce service et l’extension.
Vérifiez le titre, l’URL complète et un texte visible avant d’autoriser des actions.

Illustration reliant un agent à la recherche, aux pages web et aux documents

Choisir le navigateur à piloter

Kimi Code Desktop dispose d’un navigateur intégré dans le panneau de droite. Ses onglets appartiennent à la session courante. Choisissez l’extension si la tâche autorisée exige le profil où le site est déjà ouvert. Kimi documente Chrome et Edge. La compatibilité de l’agent et celle du navigateur se vérifient séparément.

Navigateur intégré Sessions existantes

Mode	Où il fonctionne	Quand l’utiliser
Navigateur intégré	Session Kimi Code	Ouvrir une page liée à cette session
Panneau latéral	Profil sélectionné	Travailler depuis l’onglet
Agent local	Agent, service local et extension	Utiliser un profil autorisé dans une tâche de l’agent

Le navigateur intégré et l’extension utilisent des sessions distinctes. Consultez Choisir entre le navigateur intégré de Kimi Code et WebBridge pour choisir un mode ou Profils vs Espaces de Travail vs Groupes d'Onglets : Comment Séparer Navigation Pro et Perso pour comprendre pourquoi les connexions diffèrent.

Suivre la connexion jusqu’à la page

L’agent local interroge le service sur l’interface de bouclage. L’extension se connecte au même service par WebSocket et agit dans son propre profil. L’adresse par défaut indiquée par Kimi est ws://127.0.0.1:10086/ws. Le point d’accès HTTP de l’agent et l’URL WebSocket de l’extension ont des fonctions distinctes. Dans un conteneur ou sur une autre machine, l’adresse locale désigne cet environnement.

Local Agent  ── HTTP ──►  Loopback service
Kimi extension ── WebSocket ──► Loopback service
Kimi extension ──► Browser profile ──► Test page

Si l’agent tourne ailleurs que sur la machine du navigateur, Pourquoi Codex Cloud ne peut pas ouvrir votre localhost explique ce qui change avec l’adresse.

Installer et vérifier chaque composant

Installez l’extension via les liens Kimi vers le Chrome Web Store ou Edge Add-ons. Pour une installation manuelle, décompressez le paquet officiel, ouvrez la page des extensions, activez le mode développeur et chargez le dossier décompressé.
Dans Kimi Work, installez le plugin depuis le catalogue, puis choisissez Connecter dans Paramètres > Contrôle automatique > Navigateur externe. Pour Kimi Code CLI, suivez son guide et installez le plugin du client ainsi que l’extension.
Avec un autre agent local, suivez les étapes de Kimi propres à votre client et vérifiez que le service tourne. Dans les paramètres de l’extension, ouvrez la commande à distance par agent local, lancez la connexion et vérifiez son état.

Installation officielle Kimi Code CLI

Pour choisir un profil dans un autre client local, consultez Configurer le navigateur OpenClaw et choisir son profil. La séparation entre client et navigateur apparaît aussi dans Comment contrôler un navigateur avec DeepSeek Harness.

Partir du message d’erreur

Connection refused ou Failed to connect indique que l’appel n’a pas atteint de service à l’adresse utilisée. Vérifiez l’environnement, le port et le service. Si le service répond extension_not_connected, vérifiez son lien avec l’extension, le profil actif et le port configuré aux deux extrémités. Si le démarrage signale un possible conflit de port, identifiez le processus à l’écoute avant de modifier quoi que ce soit.

Signal observé	Premier contrôle
Connection refused	De l’agent au service local
`extension_not_connected`	Du service à l’extension
URL / `WEBBRIDGE-CHECK`	Profil et repère visible

Si le service ne démarre pas, lisez le journal associé à l’erreur et identifiez le programme qui occupe le port. Kimi utilise le port 10086 par défaut. Si le conflit est confirmé, choisissez un port local libre, redémarrez le service avec la nouvelle adresse, puis testez et enregistrez l’URL WebSocket correspondante dans l’extension. Reconnectez l’agent et vérifiez dans l’état du service le port actif et la connexion de l’extension. Suivez la documentation Kimi pour le fichier de configuration et les commandes de redémarrage.

Si l’ouverture d’une page fonctionne mais que les instantanés, les captures ou les clics échouent, Kimi suggère de rechercher un conflit entre extensions. Reprenez la même action sans risque dans un profil où seule l’extension Kimi est active. Si elle réussit, comparez les extensions une à une dans ce profil.

FAQ officielle

Vérifier la fenêtre en lecture seule

Ouvrez une page de test sans données sensibles dans le bon profil. Demandez le titre, l’URL exacte et un repère visible, par exemple WEBBRIDGE-CHECK. Excluez clics, saisies et envois de formulaire. Si le repère diffère, arrêtez-vous et vérifiez l’URL et le profil. Conservez un résultat expurgé des données privées et des identifiants.

Première tâche dans le navigateur

Un tableau de bord déjà connecté dépend également du profil. Avant de l’utiliser comme page de test, consultez Codex peut-il lire un tableau de bord déjà connecté ?.

Une fois connecté, vérifiez un onglet autorisé

Un membre de r/codex a expliqué avoir piloté des onglets déjà ouverts après avoir installé l’extension et une skill compatible. Ce témoignage illustre un usage. Pour votre client, référez-vous à sa propre documentation. r/codex

Vérifiez la connexion avant de relancer la tâche

Si l’erreur d’origine concerne le service, rétablissez d’abord cette connexion. Lorsque l’extension est connectée, vérifiez le profil et contrôlez la page avec une requête en lecture seule. Relancez la tâche lorsque les informations de la page correspondent.

Secholar.L

Croissance et contenu chez Tabbit

Secholar.L rédige des guides pratiques sur les navigateurs IA et les workflows agentiques, en comparant les outils sur la base de recherches réelles et de sources vérifiables.

Questions fréquentes

Quand le panneau latéral suffit-il ?

Utilisez-le pour travailler depuis l’interface du navigateur. Utilisez le pilotage distant par un agent local si une action du navigateur fait partie d’une tâche confiée à un autre agent.

Quel profil de navigateur dois-je utiliser ?

Que signifie extension_not_connected ?

Le service local a reçu la requête, mais l’extension du navigateur ne s’y est pas encore connectée. Ouvrez le profil prévu, activez l’extension et comparez son adresse à celle du service en cours d’exécution.

Pourquoi l’agent affiche-t-il Connection refused ?

Le client n’a pas pu joindre de service à l’écoute sur cette adresse. Vérifiez l’état du service local, le port actif et l’environnement où l’agent s’exécute.

Comment vérifier que l’agent a trouvé le bon onglet ?

Ouvrez une page de test sans données sensibles dans le bon profil. Demandez le titre, l’URL exacte et un repère visible, par exemple WEBBRIDGE-CHECK. Excluez clics, saisies et envois de formulaire. Si le repère diffère, arrêtez-vous et vérifiez l’URL et le profil. Conservez un résultat expurgé des données privées et des identifiants.

L’agent et l’extension peuvent-ils utiliser des ports différents ?

Ils se connectent au même port du service local. L’agent utilise HTTP et l’extension WebSocket.