Extensión Chrome

La extensión Chrome de OpenClaw permite al agente controlar tus pestañas Chrome existentes (tu ventana normal de Chrome) en lugar de lanzar un perfil Chrome separado gestionado por openclaw.

Adjuntar/desadjuntar ocurre via un único botón de la barra de herramientas de Chrome.

Hay tres partes:

- Servicio de control de navegador (Gateway o nodo): la API que el agente/herramienta llama (via el Gateway)

- ''Servidor relay local'' (CDP loopback): puentea entre el servidor de control y la extensión (''http://127.0.0.1:18792'' por defecto)

- ''Extensión Chrome MV3'': se adjunta a la pestaña activa usando ''chrome.debugger'' y canaliza mensajes CDP al relay

OpenClaw entonces controla la pestaña adjunta a través de la superficie normal de la herramienta ''browser'' (seleccionando el perfil correcto).

1. Instala la extensión en una ruta local estable:

openclaw browser extension install

2. Imprime la ruta del directorio de extensión instalado:

openclaw browser extension path

3. Chrome → ''chrome://extensions''

- Habilita "Modo desarrollador"

- "Cargar desempaquetado" → selecciona el directorio impreso arriba

4. Fija la extensión.

La extensión se distribuye dentro del release de OpenClaw (paquete npm) como archivos estáticos. No hay un paso de "build" separado.

Después de actualizar OpenClaw:

- Vuelve a ejecutar ''openclaw browser extension install'' para refrescar los archivos instalados bajo tu directorio de estado de OpenClaw.

- Chrome → ''chrome://extensions'' → haz clic en "Recargar" en la extensión.

OpenClaw viene con un perfil de navegador integrado llamado ''chrome'' que apunta al relay de la extensión en el puerto predeterminado.

Úsalo:

- CLI: ''openclaw browser --browser-profile chrome tabs''

- Herramienta de agente: ''browser'' con ''profile="chrome"''

Si quieres un nombre diferente o un puerto de relay diferente, crea tu propio perfil:

openclaw browser create-profile \
  --name my-chrome \
  --driver extension \
  --cdp-url http://127.0.0.1:18792 \
  --color "#00AA00"

- Abre la pestaña que quieres que OpenClaw controle.

- Haz clic en el icono de la extensión.

- El badge muestra ''ON'' cuando está adjunto.

- Haz clic de nuevo para desadjuntar.

- No controla automáticamente "cualquier pestaña que estés mirando".

- Controla solo las pestañas que adjuntaste explícitamente haciendo clic en el botón de la barra de herramientas.

- Para cambiar: abre la otra pestaña y haz clic en el icono de la extensión allí.

- ''ON'': adjunto; OpenClaw puede controlar esa pestaña.

- ''…'': conectando al relay local.

- ''!'': relay no alcanzable (lo más común: el servidor relay del navegador no está ejecutándose en esta máquina).

Si ves ''!'':

- Asegúrate que el Gateway esté ejecutándose localmente (configuración predeterminada), o ejecuta un host de nodo en esta máquina si el Gateway se ejecuta en otro lugar.

- Abre la página de Opciones de la extensión; muestra si el relay es alcanzable.

#

Si el Gateway se ejecuta en la misma máquina que Chrome, inicia el servicio de control de navegador en loopback

y auto-inicia el servidor relay. La extensión habla al relay local; las llamadas CLI/herramienta van al Gateway.

#

Si tu Gateway se ejecuta en otra máquina, inicia un host de nodo en la máquina que ejecuta Chrome.

El Gateway hará proxy de acciones de navegador a ese nodo; la extensión + relay permanecen locales a la máquina del navegador.

Si múltiples nodos están conectados, fija uno con ''gateway.nodes.browser.node'' o establece ''gateway.nodes.browser.mode''.

Si tu sesión de agente está en sandbox (''agents.defaults.sandbox.mode != "off"''), la herramienta ''browser'' puede ser restringida:

- Por defecto, las sesiones en sandbox a menudo apuntan al ''navegador sandbox'' (''target="sandbox"''), no a tu Chrome host.

- La toma de control del relay de extensión Chrome requiere controlar el servidor de control de navegador del host.

Opciones:

- Lo más fácil: usa la extensión desde una sesión/agente sin sandbox.

- O permite control de navegador host para sesiones en sandbox:

{
  agents: {
    defaults: {
      sandbox: {
        browser: {
          allowHostControl: true,
        },
      },
    },
  },
}

Luego asegúrate que la herramienta no sea denegada por política de herramientas, y (si es necesario) llama ''browser'' con ''target="host"''.

Depuración: ''openclaw sandbox explain''

- Mantén el Gateway y el host de nodo en el mismo tailnet; evita exponer puertos de relay a LAN o Internet público.

- Empareja nodos intencionalmente; deshabilita el enrutamiento de proxy de navegador si no quieres control remoto (''gateway.nodes.browser.mode="off"'').

''openclaw browser extension path'' imprime el directorio en disco ''instalado'' que contiene los archivos de la extensión.

El CLI intencionalmente ''no'' imprime una ruta ''node_modules''. Siempre ejecuta ''openclaw browser extension install'' primero para copiar la extensión a una ubicación estable bajo tu directorio de estado de OpenClaw.

Si mueves o eliminas ese directorio de instalación, Chrome marcará la extensión como rota hasta que la recargues desde una ruta válida.

Esto es poderoso y riesgoso. Trátalo como darle al modelo "manos en tu navegador".

- La extensión usa la API de debugger de Chrome (''chrome.debugger''). Cuando está adjunto, el modelo puede:

- hacer clic/escribir/navegar en esa pestaña

- leer contenido de la página

- acceder a lo que la sesión iniciada de la pestaña puede acceder

- Esto no está aislado como el perfil dedicado gestionado por openclaw.

- Si te adjuntas a tu perfil/pestaña de uso diario, estás otorgando acceso a ese estado de cuenta.

Recomendaciones:

- Prefiere un perfil de Chrome dedicado (separado de tu navegación personal) para uso del relay de extensión.

- Mantén el Gateway y cualquier host de nodo solo en tailnet; confía en auth del Gateway + emparejamiento de nodo.

- Evita exponer puertos de relay sobre LAN (''0.0.0.0'') y evita Funnel (público).

- El relay bloquea orígenes que no son de extensión y requiere un token de auth interno para clientes CDP.

Relacionado:

- Resumen de herramienta de navegador: ''Navegador''

- Auditoría de seguridad: ''Seguridad''

- Configuración de Tailscale: ''Tailscale''