Extensión de Chrome

La extensión de Chrome de OpenClaw permite que un agente controle las pestañas de Chrome con sesión iniciada sin abrir un navegador administrado independiente y sin el aviso bloqueante de Chrome «Allow remote debugging?».

Esto es importante cuando se controla OpenClaw desde un teléfono (Telegram, WhatsApp, etc.): el perfil user se conecta mediante el puerto de depuración remota de Chrome, lo que muestra un cuadro de diálogo de consentimiento en el escritorio en el que nadie puede hacer clic cuando no se está presente. En su lugar, la extensión utiliza la API chrome.debugger, por lo que la única indicación dentro de la página es el aviso descartable de Chrome «OpenClaw started debugging this browser».

Es el mismo enfoque que utilizan las extensiones de Chrome de Claude de Anthropic y Codex de OpenAI.

Cómo funciona

Consta de tres partes:

• Servicio de control del navegador (Gateway o host del nodo): la API a la que llama la herramienta browser.
• Relé de la extensión (WebSocket de bucle invertido): un pequeño servidor que el servicio de control inicia en 127.0.0.1. Presenta un endpoint del protocolo Chrome DevTools a OpenClaw y se comunica con la extensión. Ambos extremos se autentican con un token local del host (véase más adelante).
• Extensión de Chrome de OpenClaw (MV3): se conecta a las pestañas con chrome.debugger, reenvía el tráfico CDP y administra el grupo de pestañas de OpenClaw.

OpenClaw solo ve y controla las pestañas que están en el grupo de pestañas de OpenClaw. El grupo es el límite del consentimiento: arrastre una pestaña al grupo para compartirla y sáquela de él (o haga clic en el botón de la barra de herramientas) para revocar el acceso al instante.

Instalación y vinculación

1. Muestre la ruta de la extensión sin empaquetar:

   openclaw browser extension path

2. Abra chrome://extensions, active Developer mode, haga clic en Load unpacked y seleccione el directorio mostrado.

3. Muestre la cadena de vinculación:

   openclaw browser extension pair

4. Haga clic en el icono de OpenClaw de la barra de herramientas y pegue la cadena de vinculación en la ventana emergente. La insignia cambia a ON cuando la extensión se conecta al relé.

El token de vinculación es un secreto local del host creado durante el primer uso y almacenado en credentials/ dentro del directorio de estado (modo 0600). Cada máquina que ejecuta un navegador —el host del Gateway y cada host de nodo de navegador— posee su propio token, por lo que ninguna credencial tiene que desplazarse entre máquinas. Para rotarlo, elimine el archivo browser-extension-relay.secret y vuelva a realizar la vinculación.

Uso

Seleccione el perfil integrado chrome en una llamada a la herramienta browser o establézcalo como predeterminado:

openclaw config set browser.defaultProfile chrome

{  browser: {    profiles: {      chrome: { driver: "extension", color: "#FF4500" },    },  },}

• Comparta una pestaña: haga clic en el botón de OpenClaw de la barra de herramientas de esa pestaña (se unirá al grupo de pestañas de OpenClaw) o arrastre cualquier pestaña al grupo.
• El agente también puede abrir nuevas pestañas, que se incorporan automáticamente al grupo.
• Revoque el acceso: vuelva a hacer clic en el botón, saque la pestaña del grupo o descarte el aviso de depuración de Chrome. El agente pierde inmediatamente el acceso a esa pestaña.

Panel lateral del copiloto de pestaña

Después de vincular la extensión, haga clic en Open tab copilot en la ventana emergente de su barra de herramientas. OpenClaw configura sidepanel.html para esa pestaña concreta de Chrome; el manifiesto no tiene una ruta global del panel lateral. Por tanto, cada pestaña obtiene un documento de panel, una sesión del Gateway, una suscripción de mensajes y un enlace tipado de la herramienta del navegador independientes.

El panel no incluye la URL, el título, el DOM ni el texto visible de la página en el mensaje. Solo envía el texto que se escribe. Las acciones del navegador incorporan un enlace independiente autenticado por el Gateway que contiene la pestaña de Chrome y el destino CDP, y la herramienta del navegador rechaza los intentos de sustituir ese destino o utilizar acciones que abarquen todo el navegador. Las respuestas permanecen en el panel (deliver: false); no heredan una ruta de Telegram, Discord ni de ningún otro canal.

El copiloto es un dispositivo dedicado vinculado al Gateway con los ámbitos operator.read y operator.write. Durante el primer uso, inspeccione y apruebe su solicitud:

openclaw devices listopenclaw devices approve <requestId>

La extensión conserva esa identidad del dispositivo y el token de dispositivo emitido por el Gateway, restringidos al endpoint canónico del Gateway que los emitió. La vinculación con un Gateway diferente crea una identidad, un token y una custodia de sesión independientes; las credenciales y las sesiones nunca se reutilizan entre endpoints. La extensión no conserva el secreto compartido del Gateway. Un panel solo puede suscribirse a sus propias sesiones de pestaña, y el Gateway filtra esos eventos antes de entregarlos.

Si la conexión con el Gateway se interrumpe durante una ejecución, la extensión mantiene la custodia persistente del ID de esa ejecución. Al volver a conectarse, cancela la ejecución sin resolver antes de volver a habilitar cualquier panel y, a continuación, recarga el historial de la transcripción. Este paso de cierre seguro evita que las acciones del navegador continúen sin ser visibles durante una interrupción de la entrega.

Al cerrar una pestaña se elimina inmediatamente su suscripción activa, se cancela cualquier ejecución visible y se marca como archivada la sesión de esa pestaña. Si el Gateway está temporalmente sin conexión, la extensión conserva el archivado pendiente y solo lo vuelve a intentar cuando se reconecta ese mismo endpoint del Gateway; nunca envía una solicitud de archivado a un Gateway diferente. Después de un fallo del navegador, el siguiente inicio archiva las sesiones dejadas por la instancia anterior del navegador. Las sesiones archivadas rechazan nuevos trabajos, mientras que sus transcripciones siguen disponibles en el historial de sesiones. Las claves del copiloto del navegador son sesiones de hilo, por lo que el mantenimiento normal por antigüedad y número de entradas las conserva. Se sigue aplicando el presupuesto de disco de sesiones por agente (valor predeterminado: 2gb) y, bajo presión, puede desalojar las sesiones más antiguas; consulte mantenimiento de sesiones.

Actualmente, el panel lateral requiere un relé de extensión alojado en el Gateway o un relé remoto directo del Gateway. Un relé de bucle invertido en un nodo de navegador todavía no puede proporcionar la ruta del nodo que exige el enlace tipado de la pestaña, por lo que el panel rechaza esa topología en lugar de recurrir al enrutamiento de todo el navegador.

Enviar una página a OpenClaw

Utilice Send page to OpenClaw en la ventana emergente de la barra de herramientas para compartir el texto legible de la página con la sesión principal de OpenClaw. Se puede añadir una nota opcional, utilizar el menú contextual de la página o de la selección, o pulsar Alt+Shift+S. OpenClaw da prioridad a la selección actual cuando existe, pone el contenido compartido en cola como evento del sistema y activa inmediatamente la sesión principal.

No es necesario que la pestaña esté en el grupo de pestañas de OpenClaw. Se trata de un contenido compartido explícito y de una sola vez: no se expone ningún otro elemento de la página ni se concede acceso continuo. Google Docs se exporta como texto sin formato mediante la sesión iniciada del navegador, sin configurar la API de Google. Los hilos de X y Twitter se extraen sin la interfaz circundante.

El texto de la página queda envuelto en el límite de seguridad para contenido externo de OpenClaw. La nota opcional permanece fuera de ese límite como instrucción propia. El texto de las páginas y las selecciones tienen un límite de aproximadamente 120,000 caracteres e incluyen un marcador de truncamiento cuando se acortan.

El uso compartido de páginas funciona cuando el relé de la extensión está alojado en el Gateway, mediante la vinculación en el mismo host o la vinculación directa con el Gateway wss://. Por ahora, los relés alojados en nodos devuelven un error claro. Para reasignar el método abreviado de teclado, abra chrome://extensions/shortcuts.

Uso remoto o entre máquinas

Chrome no tiene que ejecutarse en el host del Gateway. Se admiten tres topologías:

• Mismo host (Gateway y Chrome en una máquina): realice la vinculación en esa máquina con openclaw browser extension pair. El relé solo utiliza el bucle invertido. Si el Gateway local utiliza TLS, indique explícitamente el nombre de host de su certificado mediante --gateway-url wss://gateway-host.example; la vinculación nunca lo sustituye por una IP de bucle invertido.
• Conexión directa a un Gateway remoto (Chrome en el portátil, el Gateway en un VPS y nada más en el portátil): ejecute openclaw browser extension pair --gateway-url wss://your-gateway.example.com en el Gateway. Se muestra una cadena wss://…/browser/extension#<secret>; cargue y vincule la extensión en el portátil. La extensión se conecta directamente al Gateway mediante wss://: no se requiere instalar OpenClaw, Node ni la CLI, ni abrir ningún puerto de entrada en el portátil. Esta es la opción para alojamiento administrado.
• Mediante un host de nodo de navegador (Chrome en una máquina que ya ejecuta un nodo de OpenClaw): ejecute pair en el nodo y realice la vinculación localmente; el Gateway redirige las acciones del navegador al nodo mediante su enlace de nodo autenticado existente.

El secreto de vinculación es específico de cada host (el del Gateway en el caso directo) y se valida mediante la ruta /browser/extension del Gateway. Para la ruta directa, sirva el Gateway mediante TLS (wss://) para cifrar el secreto de vinculación y el tráfico CDP. El secreto permanece en el fragmento de URL de la cadena de vinculación y se presenta durante el protocolo de enlace WebSocket como credencial de subprotocolo, por lo que los registros normales de acceso del proxy no lo reciben en la URL de la solicitud. Asegúrese de que cualquier proxy inverso conserve el encabezado estándar Sec-WebSocket-Protocol.

Diagnóstico

openclaw browser status --browser-profile chromeopenclaw browser doctor --browser-profile chrome

doctor indica que la comprobación del relé de la extensión de Chrome falla hasta que la ventana emergente de la extensión muestra Connected.

Modelo de seguridad

• El relé solo se enlaza al bucle invertido; ambos extremos de WebSocket se autentican con el token derivado y se comprueba que el origen de la extensión sea chrome-extension://.
• La vinculación directa con el Gateway no acepta el token del relé en la URL de la solicitud; en su lugar, la extensión incluida lo incorpora en la lista de subprotocolos de WebSocket.
• El agente solo puede ver y controlar las pestañas del grupo de pestañas de OpenClaw. Las demás pestañas permanecen privadas.
• Las ejecuciones del panel lateral tienen una doble restricción: la entrega del Gateway utiliza una lista de permitidos por sesión y las herramientas del navegador hacen cumplir el enlace con la pestaña o el destino de Chrome que se transmite fuera del prompt.
• En comparación con el perfil user (Chrome MCP), que expone todo el navegador con sesión iniciada una vez aprobado el aviso de depuración remota, la extensión mantiene la superficie compartida restringida a un grupo de pestañas que se puede controlar de un vistazo.

Consulte también Navegador para conocer el modelo completo de perfiles y los perfiles administrados openclaw y user de Chrome MCP.