FAQ
Version du produit
Quelle est la relation entre Kimi WebBridge et l'Extension de navigateur Kimi ?
Kimi WebBridge a été renommé Extension de navigateur Kimi, avec de nouvelles fonctionnalités, notamment une entrée via la barre latérale du navigateur, l'enregistrement des actions web et la décomposition des pages web en instructions. La manière dont les Agents locaux appellent l'extension reste inchangée et peut continuer à être utilisée ; la nouvelle entrée via la barre latérale nécessite de se connecter avec votre compte Kimi.
Utiliser la barre latérale
L'historique des conversations est-il synchronisé avec kimi.com et Kimi Desktop ?
Non. L'historique des conversations de la barre latérale est enregistré uniquement dans le navigateur actuel, et chaque compte conserve par défaut les 10 conversations les plus récentes. Pour conserver vos conversations durablement, cliquez sur « Export » sous une réponse afin d'enregistrer le contenu au format Markdown (.md).
Installation et configuration
Quels navigateurs sont pris en charge ?
Actuellement, Chrome et Edge sont pris en charge. Nous recommandons d'utiliser la dernière version pour une expérience optimale.
Le message « Impossible d'ajouter des applications depuis ce site web » s'affiche lors de l'installation de l'extension ?
Veillez à effectuer l'installation depuis la boutique en ligne officielle (Chrome Web Store ou Edge Add-ons). Si vous ne pouvez pas y accéder, utilisez la méthode d'installation manuelle proposée sur le site officiel.
Sous Windows, l'installation de l'Extension de navigateur Kimi échoue avec l'erreur « Échec de l'installation »
L'Extension de navigateur Kimi prend en charge le système d'exploitation Windows, et la commande d'installation peut s'exécuter dans PowerShell :
L'Extension de navigateur Kimi affiche un avertissement de compatibilité Chrome après l'installation. Qu'est-ce que cela signifie ?
Si l'Extension de navigateur Kimi ouvre les pages normalement, mais que des actions telles que snapshot, evaluate, screenshot ou click échouent systématiquement, la cause la plus fréquente est un conflit avec d'autres extensions de navigateur.
C'est particulièrement courant avec les outils de scraping, les extensions d'assistance aux sites web, les extensions d'enregistrement d'écran et les extensions d'assistant IA.
Nous recommandons les étapes suivantes pour diagnostiquer le problème :
- Ouvrez la page de gestion des extensions de votre navigateur
- Désactivez temporairement les autres extensions
- Ne conservez que l'Extension de navigateur Kimi activée
- Redémarrez le navigateur et réessayez
- Si l'Extension de navigateur Kimi fonctionne normalement, réactivez les autres extensions une par une pour identifier celle qui pose problème
Rien ne se passe après l'exécution de la commande de connexion ?
Vérifiez votre connexion Internet. Si le problème persiste, redémarrez Kimi Claw Desktop et exécutez à nouveau la commande.
Puis-je l'utiliser sur plusieurs ordinateurs ?
Oui, mais chaque ordinateur doit être installé et configuré séparément.
Je ne trouve pas Kimi Claw Desktop ?
Kimi Claw Desktop est un Kimi Claw déployé sur votre ordinateur local. Ouvrez Kimi Desktop, repérez Kimi Claw dans la barre latérale gauche, créez un nouveau Claw, puis sélectionnez « Déployer sur mon ordinateur ».
Connexion et utilisation
Mon Agent local ne peut pas utiliser le navigateur, comment vérifier la connexion ?
- Dans la barre latérale Kimi, consultez « Connection » dans « Settings » → « Local agent remote control » : si l'état affiche « Not connected », cliquez sur « Connect » pour réessayer.
- Dans Kimi Work, vous pouvez aussi consulter l’état de « Connecter le service » dans « Paramètres » → « Automatisation » → « Browser use », puis cliquer sur « Connecter » pour réessayer.
Remarque : pouvoir ouvrir la barre latérale ne signifie pas que la connexion de l'Agent local est configurée.
Si Kimi Work ou un autre Agent local ne parvient pas à utiliser le navigateur, consultez d'abord l'erreur brute renvoyée par l'outil :
| Champ ou message d'erreur | Signification et vérifications |
|---|---|
error.code vaut extension_not_connected | Le service local a reçu la requête, mais l'extension n'est pas connectée. Vérifiez le navigateur et l'extension à l'étape 1, puis l'adresse à l'étape 4 |
Connection refused ou Failed to connect lors de l'accès au service local | Le service local n'a pas été joint. Vérifiez l'installation et le démarrage aux étapes 2 et 3, puis l'adresse à l'étape 4 |
daemon did not come up accompagné de Port … is most likely held by another program au démarrage | Le service n'a pas démarré, peut-être à cause d'un port occupé. Vérifiez l'étape 5 et les journaux joints |
Effectuez les vérifications dans cet ordre :
1. Le navigateur est-il ouvert et l'extension activée ?
Ouvrez Chrome ou Edge avec l'Extension de navigateur Kimi installée et vérifiez son activation sur la page des extensions. Cliquez ensuite sur « Connecter » dans Kimi Work ou sur « Connect » dans les paramètres de l'extension.
2. Avez-vous installé uniquement l'extension, sans configurer l'Agent local ?
L'extension et les composants de connexion de l'Agent local sont tous deux nécessaires. Dans Kimi Work, installez le plugin Kimi Browser Extension depuis le catalogue de plugins, puis suivez les instructions d'installation et de connexion.
Pour un autre Agent local, ou si le service local n'est pas encore configuré, cliquez sur « Connect » dans l'extension et transmettez à votre Agent les instructions affichées. Vous pouvez aussi copier la consigne adaptée à votre système :
macOS ou Linux
Windows
Vérifiez que l'installation et le démarrage ont réussi, puis consultez de nouveau « Connection ».
3. Le service installé est-il en cours d'exécution ?
Une installation terminée ne garantit pas que le service reste actif. Dans Kimi Work, cliquez d'abord sur « Connecter » dans les paramètres indiqués. Avec un autre Agent local, demandez-lui de vérifier le service local de l'Extension de navigateur Kimi et de le démarrer si nécessaire. Cliquez ensuite sur « Connect » dans l'extension. Si le démarrage échoue, recherchez un conflit de port.
4. L'adresse de l'extension correspond-elle à celle du service local ?
Vérifiez « Settings » → « Local agent remote control » → « Connection address ». L'adresse par défaut est ws://127.0.0.1:10086/ws. Si le port du service a changé, l'extension doit utiliser le même port. Modifier un seul côté empêche la connexion.
5. L'erreur mentionne-t-elle un possible conflit de port ?
Si le démarrage affiche Port … is most likely held by another program, demandez à votre Agent local de vérifier le port indiqué, le programme qui l'utilise et les journaux joints. Ce message signale une possibilité, sans prouver la cause. Une fois le conflit confirmé, suivez le guide ci-dessous.
Si la connexion échoue toujours, utilisez « Settings » → « Feedback » dans l'extension. Joignez les versions de Kimi Work ou de l'Agent local, du navigateur et de l'extension, une capture de l'état de connexion, l'erreur complète et les étapes déjà essayées.
Que faire si le port est occupé ? Comment changer le port de connexion ?
Le service de connexion local utilise le port 10086 par défaut. Identifiez d’abord le programme qui l’occupe. Si vous pouvez le fermer, faites-le, puis réessayez la connexion. S’il doit rester actif, suivez les étapes ci-dessous pour changer de port.
Kimi Work 3.2.18 et les autres Agents locaux peuvent suivre la même procédure de changement de port. Si vous utilisez une ancienne version de Work, passez d’abord à la version 3.2.18 ou ultérieure. Le service local de l’Extension de navigateur Kimi doit être en version v2.0.22 ou ultérieure.
Vous pouvez modifier ensemble le port du service local et celui de l'extension. L'exemple utilise 12086 ; demandez d'abord à votre Agent de vérifier qu'il est libre. Attendez la fin des tâches du navigateur : redémarrer le service interrompt la connexion actuelle.
1. Modifiez la configuration du service local.
Ouvrez le fichier suivant ou créez-le s’il n’existe pas. Conservez les autres champs et modifiez uniquement addr. En cas d’erreur de configuration, vérifiez la syntaxe JSON et le format de addr à l’aide de l’exemple ci-dessous, corrigez le fichier et réessayez :
- macOS / Linux :
~/.kimi-webbridge/config.json - Windows :
%USERPROFILE%\.kimi-webbridge\config.json
2. Redémarrez le service local et vérifiez son état.
Exécutez les commandes correspondant à votre système, ou demandez à votre Agent local de le faire :
Vérifiez que running: true et que port vaut 12086. Si l’ancien port s’affiche encore ou que le démarrage échoue, corrigez d’abord l’erreur du service. Work réutilise un service actif en bon état ; enregistrer la configuration ou rouvrir Work ne le déplace pas automatiquement vers le nouveau port.
3. Modifiez l'adresse de connexion de l'extension.
Dans la barre latérale, ouvrez « Settings » → « Local agent remote control » → « Connection address ». Saisissez ws://127.0.0.1:12086/ws, cliquez sur « Test », puis sur « Save » si le test réussit. Vérifiez ensuite que « Connection » affiche « Connected ».
4. Indiquez la nouvelle adresse à votre Agent local.
Dans Kimi Work, rouvrez Work après ces étapes, puis cliquez sur « Connecter » dans « Paramètres » → « Automatisation » → « Browser use ». Pour un autre Agent local, indiquez que le service utilise maintenant 127.0.0.1:12086 et qu’il doit utiliser le port réel renvoyé par status. extension_connected: true indique que l’extension est connectée. Si la valeur est false, vérifiez que le navigateur est ouvert, que l’extension est activée et que l’adresse correspond à l’étape 3.
Pour rétablir le port par défaut, remettez addr à 127.0.0.1:10086, redémarrez le service, puis cliquez sur « Reset to default » dans « Connection address ». Vérifiez auparavant qu'aucun autre programme n'utilise 10086.
L'Extension de navigateur Kimi risque-t-elle de divulguer mes informations de connexion ?
Non. Toute l'exécution se déroule localement sur votre appareil : les états de connexion et le contenu des pages web ne quittent jamais votre machine. L'Agent ne peut accéder qu'aux résultats d'opération que vous autorisez.
Pourquoi les opérations échouent-elles ?
Des structures de page complexes ou un chargement dynamique peuvent faire échouer les opérations. Essayez de simplifier vos instructions, ou demandez d'abord à l'Agent de faire une capture d'écran pour confirmer l'état de la page avant d'exécuter l'action.
Utilisation avec d'autres agents
Quels autres Agents sont pris en charge ?
L'Extension de navigateur Kimi prend en charge tous les Local Agents, notamment Claude Code, Codex, Cursor, Kimi Code, Hermes Claw, et bien d'autres.
La configuration est-elle la même pour les différents Agents ?
La commande de configuration est identique pour tous : il suffit d'exécuter une seule commande curl pour l'installation. Reportez-vous à la configuration des Skills de chaque Agent pour plus de détails.
Cet article vous a-t-il été utile ?