Preguntas frecuentes
Versión del producto
¿Cuál es la relación entre Kimi WebBridge y la Extensión de navegador Kimi?
Kimi WebBridge pasó a llamarse Extensión de navegador Kimi e incorporó nuevas funciones, como la entrada desde la barra lateral del navegador, la grabación de acciones web y la descomposición de páginas web en instrucciones. La forma en que los Local Agents invocan la extensión se mantiene sin cambios, así que puedes seguir usándola; la nueva entrada desde la barra lateral requiere iniciar sesión con tu cuenta de Kimi.
Usar la barra lateral
¿El historial de conversaciones se sincroniza con kimi.com y Kimi Desktop?
No. El historial de conversaciones de la barra lateral solo se guarda en el navegador actual, y cada cuenta conserva de forma predeterminada las 10 conversaciones más recientes. Para guardarlas a largo plazo, haz clic en “Export” debajo de la respuesta para guardar el contenido como un archivo Markdown (.md).
Instalación y configuración
¿Qué navegadores son compatibles?
Actualmente es compatible con Chrome y Edge. Te recomendamos usar la versión más reciente para obtener la mejor experiencia.
¿Aparece el mensaje “No se pueden agregar aplicaciones desde este sitio web” al instalar la extensión?
Asegúrate de instalarla desde la tienda web oficial (Chrome Web Store o Edge Add-ons). Si no puedes acceder a la tienda web, usa el método de instalación manual que se indica en el sitio web oficial.
En Windows, al instalar la Extensión de navegador Kimi aparece el error: Error de instalación
La Extensión de navegador Kimi es compatible con el sistema operativo Windows, y el comando de instalación se puede ejecutar en PowerShell:
La Extensión de navegador Kimi muestra una advertencia de compatibilidad con Chrome después de la instalación. ¿Qué significa?
Si la Extensión de navegador Kimi puede abrir páginas con normalidad, pero acciones como snapshot, evaluate, screenshot o click siguen fallando, la causa más común es un conflicto con otras extensiones del navegador.
Esto ocurre con especial frecuencia con herramientas de scraping, extensiones de asistencia para sitios web, extensiones de grabación de pantalla y extensiones de asistente de IA.
Te recomendamos seguir estos pasos para diagnosticar el problema:
- Abre la página de administración de extensiones de tu navegador
- Desactiva temporalmente las demás extensiones
- Deja activada únicamente la Extensión de navegador Kimi
- Reinicia el navegador e inténtalo de nuevo
- Si la Extensión de navegador Kimi funciona con normalidad, vuelve a activar las demás extensiones una por una para identificar cuál genera el conflicto
¿No pasa nada después de ejecutar el comando de conexión?
Revisa tu conexión a internet. Si el problema persiste, intenta reiniciar Kimi Claw Desktop y ejecuta el comando de nuevo.
¿Puedo usarlo en varias computadoras?
Sí, pero cada computadora debe instalarse y configurarse por separado.
¿No encuentro Kimi Claw Desktop?
Kimi Claw Desktop es un Kimi Claw implementado en tu computadora local. Abre Kimi Desktop, busca Kimi Claw en la barra lateral izquierda, crea un nuevo Claw y selecciona “Implementar en mi computadora”.
Conexión y uso
¿Cómo reviso la conexión? ¿Qué hago si mi Agent local no puede usar el navegador?
- En la barra lateral de Kimi, abre “Settings” → “Local agent remote control” y revisa “Connection”: si aparece “Not connected”, haz clic en “Connect” para reintentar.
- Si usas Kimi Work, también puedes revisar el estado de “Conectar servicio” en “Configuración” → “Control automático” → “Browser use”, y hacer clic en “Conectar” para reintentar.
Nota: poder abrir la barra lateral no significa que la conexión del Agent local esté configurada.
Si Kimi Work u otro Agent local no puede usar el navegador, revisa primero el error original que devuelve la herramienta:
| Campo o mensaje del error | Significado y revisión |
|---|---|
error.code es extension_not_connected | El servicio local recibió la solicitud, pero la extensión no está conectada. Revisa el navegador y la extensión en el paso 1, y la dirección en el paso 4 |
Connection refused o Failed to connect al acceder al servicio local | La llamada no llegó al servicio local. Revisa la instalación y el inicio en los pasos 2 y 3, y la dirección en el paso 4 |
Al iniciar aparecen daemon did not come up y Port … is most likely held by another program | El servicio no pudo iniciarse, posiblemente por un puerto ocupado. Confírmalo en el paso 5 y revisa los registros adjuntos |
Sigue estas comprobaciones en orden:
1. ¿El navegador está abierto y la extensión está habilitada?
Abre Chrome o Edge con la Extensión de navegador Kimi instalada y verifica que esté habilitada en la página de extensiones. Luego haz clic en “Conectar” en Kimi Work o en “Connect” en los ajustes de la extensión.
2. ¿Solo instalaste la extensión, sin configurar el Agent local?
Se necesitan tanto la extensión como los componentes de conexión del Agent local. En Kimi Work, instala el plugin Kimi Browser Extension desde el catálogo de plugins y sigue las instrucciones de instalación y conexión.
Si usas otro Agent local o aún no configuraste el servicio, haz clic en “Connect” en la extensión y envía al Agent las instrucciones del cuadro de diálogo. También puedes copiar la indicación correspondiente a tu sistema operativo:
macOS o Linux
Windows
Confirma que la instalación y el inicio del servicio se completaron correctamente, y vuelve a revisar “Connection”.
3. ¿El servicio local instalado está en ejecución?
Instalar el servicio no significa que siga ejecutándose. En Kimi Work, primero haz clic en “Conectar” en los ajustes indicados. Con otro Agent local, pídele que revise el servicio local de la Extensión de navegador Kimi y lo inicie si hace falta. Después haz clic en “Connect” en la extensión. Si no inicia, revisa si hay un conflicto de puerto.
4. ¿La dirección de la extensión coincide con la del servicio local?
Revisa “Settings” → “Local agent remote control” → “Connection address”. La dirección predeterminada es ws://127.0.0.1:10086/ws. Si cambiaste el puerto del servicio, la extensión debe usar el mismo. Cambiar solo uno de los dos impide la conexión.
5. ¿El error menciona un posible puerto ocupado?
Si aparece Port … is most likely held by another program, pide al Agent local que revise el puerto indicado, el programa que lo usa y los registros adjuntos. El mensaje señala una posibilidad, no confirma la causa. Una vez verificado el conflicto, sigue la guía de puertos que aparece abajo.
Si aún no puedes conectarte, usa “Settings” → “Feedback” en la extensión. Incluye las versiones de Kimi Work o del Agent local, del navegador y de la extensión, una captura del estado de conexión, el error completo y los pasos que intentaste.
¿Qué hago si el puerto está ocupado? ¿Cómo cambio el puerto de conexión?
El servicio de conexión local usa el puerto 10086 de forma predeterminada. Identifica primero el programa que lo ocupa. Si puedes cerrarlo, ciérralo y reintenta la conexión. Si debe seguir ejecutándose, sigue estos pasos para cambiar el puerto.
Kimi Work 3.2.18 y otros Agents locales pueden seguir el mismo procedimiento para cambiar el puerto. Si usas una versión anterior de Work, actualiza primero a la 3.2.18 o posterior. El servicio local de la Extensión de navegador Kimi debe ser v2.0.22 o posterior.
Puedes cambiar el puerto tanto del servicio como de la extensión. El ejemplo usa 12086; pide primero al Agent local que confirme que está libre. Espera a que terminen las tareas del navegador, ya que reiniciar el servicio interrumpe la conexión actual.
1. Edita la configuración del servicio local.
Abre el siguiente archivo o créalo si no existe. Conserva los demás campos y modifica solo addr. Si aparece un error de configuración, revisa la sintaxis JSON y que addr tenga el formato de dirección del ejemplo; corrígelo y reintenta:
- macOS / Linux:
~/.kimi-webbridge/config.json - Windows:
%USERPROFILE%\.kimi-webbridge\config.json
2. Reinicia el servicio local y revisa su estado.
Ejecuta los comandos para tu sistema operativo o pide a tu Agent local que los ejecute:
Confirma running: true y que port sea 12086. Si sigue apareciendo el puerto anterior o falla el inicio, resuelve primero el error del servicio. Work reutiliza un servicio activo que funciona correctamente; guardar la configuración o volver a abrir Work no lo mueve automáticamente al puerto nuevo.
3. Cambia la dirección de conexión de la extensión.
En la barra lateral, abre “Settings” → “Local agent remote control” → “Connection address”, ingresa ws://127.0.0.1:12086/ws y haz clic en “Test”. Si la prueba tiene éxito, haz clic en “Save”. Regresa a los ajustes y confirma que “Connection” muestre “Connected”.
4. Indica a tu Agent local que use la nueva dirección.
En Kimi Work, vuelve a abrir Work después de estos pasos y haz clic en “Conectar” en “Configuración” → “Control automático” → “Browser use”. Para otro Agent local, indícale que el servicio ahora usa 127.0.0.1:12086 y que continúe con el puerto real que devuelve status. extension_connected: true indica que la extensión está conectada. Si es false, revisa que el navegador esté abierto, la extensión esté habilitada y la dirección coincida con el paso 3.
Para volver al valor predeterminado, cambia addr a 127.0.0.1:10086, reinicia el servicio y haz clic en “Reset to default” en la página “Connection address”. Antes confirma que ningún otro programa ocupe 10086.
¿La Extensión de navegador Kimi filtrará mi información de inicio de sesión?
No. Toda la ejecución ocurre de forma local en tu dispositivo: los estados de inicio de sesión y el contenido de las páginas web nunca salen de tu máquina. El Agent solo puede acceder a los resultados de las operaciones que autorices.
¿Por qué fallan las operaciones?
Las estructuras de página complejas o la carga dinámica pueden hacer que las operaciones fallen. Intenta simplificar tus instrucciones o pídele al Agent que tome primero una captura de pantalla para confirmar el estado de la página antes de ejecutar.
Uso con otros agentes
¿Con qué otros Agents es compatible?
La Extensión de navegador Kimi es compatible con todos los Local Agents, incluidos Claude Code, Codex, Cursor, Kimi Code, Hermes Claw y más.
¿La configuración es la misma para los distintos Agents?
El comando de configuración es el mismo para todos: basta con ejecutar un único comando de curl para instalarlo. Consulta la configuración de Skills de cada Agent para conocer los detalles.
¿Te resultó útil este artículo?