Instalar Kimi WebBridge y reparar la conexión

Kimi WebBridge ahora se llama Kimi Browser Extension. Si la barra lateral se abre pero el agente local indica que el navegador está desconectado, revisa por separado la extensión, el servicio y el agente. Empieza por el mensaje original de la herramienta. El indicador de estado no te dice por sí solo dónde falló la conexión.

Kimi Browser Extension

Un usuario de r/kimi contó que Claw daba WebBridge por desconectado aunque la extensión aparecía activa. Ese síntoma es un buen motivo para revisar cada tramo de la conexión. r/kimi

Puntos clave

• Kimi documenta Chrome y Edge en macOS o Windows. Instala la extensión en el perfil que ejecutará la tarea.

• La barra lateral y el control desde un agente local se configuran por separado. Que la barra esté activa solo confirma una parte del proceso.

• Connection refused apunta al servicio local. extension_not_connected apunta a la conexión entre ese servicio y la extensión.

• Comprueba el título, la URL completa y un texto visible antes de autorizar acciones.

Elige el navegador que debe usar el agente

Kimi Code Desktop tiene un navegador integrado en el panel derecho. Sus pestañas pertenecen a esa sesión. Elige la extensión si la tarea autorizada necesita el perfil donde ya tienes abierta la página. Kimi documenta Chrome y Edge. Comprueba por separado la compatibilidad del agente y la del navegador.

Navegador integrado Sesiones existentes

El navegador integrado y la extensión usan sesiones distintas. Consulta Cuándo elegir el navegador integrado de Kimi Code o WebBridge para elegir la entrada o Perfiles vs Espacios de Trabajo vs Grupos de Pestañas: Cómo Separar el Trabajo de lo Personal para entender por qué cambian las sesiones de inicio.

Sigue la conexión hasta la página

El agente local llama al servicio en la interfaz de bucle local. La extensión se conecta a ese servicio por WebSocket y actúa desde su propio perfil. La dirección predeterminada en las preguntas frecuentes de Kimi es ws://127.0.0.1:10086/ws. El punto HTTP del agente y la URL WebSocket de la extensión cumplen funciones distintas. Si el agente se ejecuta en un contenedor u otro equipo, su dirección local apunta a ese entorno.

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

Si el agente se ejecuta fuera del equipo del navegador, Por qué Codex Cloud no abre el localhost de tu equipo explica qué cambia con la dirección.

Instala y verifica cada componente

1. Instala la extensión desde Chrome Web Store o Edge Add-ons usando los enlaces de Kimi. Para la instalación manual, descomprime el paquete oficial, abre la página de extensiones, activa el modo desarrollador y carga la carpeta descomprimida.

2. En Kimi Work, añade el plugin desde su catálogo y pulsa Conectar en Ajustes > Control automático > Navegador externo. Para Kimi Code CLI, sigue su guía e instala tanto el plugin del cliente como la extensión.

3. Para otro agente local, sigue las instrucciones de Kimi para ese cliente y confirma que el servicio está en ejecución. En la extensión, entra en Ajustes > Control remoto por agente local, conecta y comprueba el estado.

Instalación oficial Kimi Code CLI

Para elegir un perfil en otro cliente local, consulta Configurar el navegador de OpenClaw y elegir perfil. La separación entre cliente y navegador también se ve en Cómo controlar un navegador con DeepSeek Harness.

Localiza el fallo con el error original

Connection refused o Failed to connect indican que no se llegó a un servicio que escuchara en esa dirección. Comprueba el entorno, el puerto y el proceso. Si el servicio devuelve extension_not_connected, revisa el tramo entre el servicio y la extensión. Comprueba que esté activada en el perfil correcto y que ambos extremos usen el mismo puerto. Si se indica un posible conflicto, identifica el proceso que escucha antes de cambiar nada.

Si el servicio falla al arrancar, consulta el registro del error e identifica qué programa está usando el puerto. Kimi usa el 10086 por defecto. Si confirmas un conflicto, elige un puerto local libre, reinicia el servicio con la nueva dirección y prueba y guarda la URL WebSocket correspondiente en la extensión. Vuelve a conectar el agente y comprueba en el estado del servicio el puerto efectivo y la conexión de la extensión. Sigue la documentación de Kimi para editar el archivo de configuración y reiniciar el servicio.

Si puedes abrir una página pero fallan la captura, la instantánea o los clics, Kimi sugiere comprobar si hay un conflicto con otra extensión. Prueba la misma acción inocua en un perfil dedicado que tenga solo la extensión de Kimi. Si funciona, compara las extensiones una por una en ese perfil.

Preguntas frecuentes oficiales

Confirma la ventana con una prueba de solo lectura

Abre una página de prueba sin datos sensibles en el perfil elegido. Pide al agente el título, la URL exacta y un marcador visible, como WEBBRIDGE-CHECK. Prohíbe los clics, la escritura y el envío de formularios. Si el marcador no coincide, detente y comprueba la URL y el perfil. Guarda un resultado sin contenido privado ni credenciales.

Primera tarea de navegador

Un panel con sesión iniciada depende del perfil. Antes de probar con uno, consulta ¿Puede Codex leer un panel en el que ya iniciaste sesión?.

Tras conectar, comprueba una pestaña autorizada

Un usuario de r/codex describió cómo controló pestañas que ya tenía abiertas tras instalar la extensión y una skill compatible. Es un ejemplo de uso. Consulta la documentación de tu cliente para saber qué configuración admite. r/codex

Comprueba la conexión antes de repetir la tarea

Si el error original apunta al servicio, recupera primero esa conexión. Una vez conectada la extensión, comprueba el perfil y verifica la página con una petición de solo lectura. Repite la tarea cuando coincidan los datos de la página.

Secholar.L

Crecimiento y contenido en Tabbit

Secholar.L escribe guías prácticas sobre navegadores con IA y flujos de trabajo con agentes, comparando herramientas con investigación real y fuentes verificables.