Extensión de Chrome

La extensión de Chrome de OpenClaw permite que un agente controle tus pestañas de Chrome con sesión iniciada sin lanzar un navegador gestionado separado y sin el aviso bloqueante de Chrome "¿Permitir depuración remota?".

Esto importa cuando controlas 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 diálogo de consentimiento en el escritorio que nadie puede pulsar cuando estás lejos. En su lugar, la extensión usa la API chrome.debugger, así que la única señal dentro de la página es el banner descartable de Chrome "OpenClaw empezó a depurar este navegador".

Esta es la misma estructura que usan las extensiones de Chrome de Claude de Anthropic y Codex de OpenAI.

Cómo funciona

Tres partes:

• Servicio de control del navegador (Gateway o host de nodo): la API a la que llama la herramienta browser.
• Relay de la extensión (WebSocket loopback): un servidor pequeño que el servicio de control inicia en 127.0.0.1. Presenta a OpenClaw un endpoint de Chrome DevTools Protocol y se comunica con la extensión. Ambos lados se autentican con un token local del host (ver abajo).
• Extensión de Chrome de OpenClaw (MV3): se adjunta a las pestañas con chrome.debugger, reenvía el tráfico CDP y gestiona 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 de consentimiento: arrastra una pestaña dentro para compartirla, arrástrala fuera (o pulsa el botón de la barra de herramientas) para revocar el acceso al instante.

Instalar y emparejar

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

   openclaw browser extension path

2. Abre chrome://extensions, activa Modo de desarrollador, haz clic en Cargar sin empaquetar y selecciona el directorio impreso.

3. Imprime la cadena de emparejamiento:

   openclaw browser extension pair

4. Haz clic en el icono de OpenClaw en la barra de herramientas y pega la cadena de emparejamiento en el popup. La insignia cambia a ACTIVADO cuando la extensión se conecta al relay.

El token de emparejamiento es un secreto local del host creado en el primer uso y almacenado bajo credentials/ en el directorio de estado (modo 0600). Cada máquina que ejecuta un navegador —el host de Gateway y cada host de nodo de navegador— tiene su propio token, así que ninguna credencial tiene que viajar entre máquinas. Para rotarlo, elimina el archivo browser-extension-relay.secret y empareja de nuevo.

Usarlo

Selecciona el perfil integrado chrome en una llamada a la herramienta browser, o conviértelo en el predeterminado:

openclaw config set browser.defaultProfile chrome

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

• Compartir una pestaña: haz clic en el botón de OpenClaw en la barra de herramientas en esa pestaña (se une al grupo de pestañas de OpenClaw), o arrastra cualquier pestaña al grupo.
• El agente también puede abrir pestañas nuevas; estas entran automáticamente en el grupo.
• Revocar: haz clic de nuevo en el botón, arrastra la pestaña fuera del grupo o descarta el banner de depuración de Chrome. El agente pierde el acceso a esa pestaña de inmediato.

Nodos de navegador remotos

La extensión funciona tanto si Chrome se ejecuta en el host de Gateway como en un host de nodo de navegador separado. El relay siempre es solo loopback y se ejecuta en la máquina con el navegador:

• Mismo host (Gateway + Chrome en una máquina): empareja en esa máquina.
• Nodo remoto (Chrome en un nodo, Gateway en otro lugar): ejecuta openclaw browser extension path / pair en el nodo, carga y empareja la extensión allí. Gateway proxifica las acciones del navegador hacia el nodo mediante su enlace de nodo autenticado existente; el relay local del nodo controla la extensión. No se abre ningún puerto entrante nuevo en el nodo.

El token de emparejamiento es por host, así que cada nodo imprime su propia cadena.

Diagnóstico

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

doctor informa que la comprobación del relay de la extensión de Chrome falla hasta que el popup de la extensión muestra Conectado.

Modelo de seguridad

• El relay se vincula solo a loopback; ambos lados del WebSocket se autentican con el token derivado, y el lado de la extensión se verifica por origen como chrome-extension://.
• El agente solo puede ver y controlar pestañas en el grupo de pestañas de OpenClaw. Tus otras pestañas permanecen privadas.
• En comparación con el perfil user (Chrome MCP), que expone todo tu navegador con sesión iniciada una vez que apruebas el aviso de depuración remota, la extensión mantiene la superficie compartida limitada a un grupo de pestañas que controlas de un vistazo.

Ver también: Navegador para el modelo completo de perfiles y los perfiles gestionados openclaw y user de Chrome MCP.