Gestiona navegadores aislados con OpenClaw

¿Alguna vez has ejecutado un script de automatización y has visto con horror cómo cerraba tus pestañas de trabajo o mezclaba cookies de tus sesiones activas? Es frustrante cuando las herramientas de desarrollo invaden tu espacio personal. Necesitas una barrera clara entre tus procesos automáticos y tu navegación diaria para evitar desastres.

OpenClaw soluciona esto mediante el uso de un perfil de navegador dedicado (Chrome, Brave, Edge o Chromium) que el agente controla de forma independiente. Este perfil está aislado y se gestiona a través de un servicio de control local dentro del Gateway.

Te recomiendo usar el perfil openclaw en lugar del perfil predeterminado del sistema. Es la mejor forma de asegurar que el agente trabaje en un entorno seguro y predecible, permitiéndole abrir pestañas, hacer clic o escribir sin tocar tus datos personales.

What You’ll Need

• Acceso a la CLI de openclaw.
• Un navegador basado en Chromium instalado en tu sistema.

Quick Start

Puedes empezar a controlar tu navegador gestionado en menos de cinco minutos usando estos comandos:

openclaw browser --browser-profile openclaw status
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot

Perfiles: openclaw vs chrome

Es importante que entiendas la diferencia entre estas dos opciones para elegir la que mejor se adapte a tu flujo de trabajo:

• openclaw: Es un navegador gestionado y totalmente aislado. No requiere extensiones y es la opción recomendada para automatización pura.
• chrome: Utiliza el navegador por defecto de tu sistema mediante un relay. Requiere que la extensión de OpenClaw esté instalada y activa en una pestaña.

Si prefieres que el modo gestionado sea el predeterminado, edita tu configuración y establece browser.defaultProfile: "openclaw".

Configuration

Los ajustes del navegador se guardan en ~/.openclaw/openclaw.json. Aquí tienes un ejemplo de cómo configurar el archivo:

{
  browser: {
    enabled: true, // default: true
    remoteCdpTimeoutMs: 1500,
    remoteCdpHandshakeTimeoutMs: 3000,
    defaultProfile: "chrome",
    color: "#FF4500",
    headless: false,
    noSandbox: false,
    attachOnly: false,
    executablePath: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
    profiles: {
      openclaw: { cdpPort: 18800, color: "#FF4500" },
      work: { cdpPort: 18801, color: "#0066CC" },
      remote: { cdpUrl: "http://10.0.0.42:9222", color: "#00AA00" },
    },
  },
}

El servicio de control se vincula a un puerto derivado del puerto del Gateway (por defecto 18791). Si cambias el puerto del Gateway, los puertos del navegador se ajustarán automáticamente para mantenerse en el mismo rango.

Troubleshooting

Error: “Browser disabled” Si recibes este mensaje al intentar ejecutar comandos, significa que la funcionalidad está desactivada. Para solucionarlo, cambia enabled: true en tu archivo de configuración y reinicia el Gateway.

Si necesitas ayuda personalizada para configurar tu entorno, consulta el AI Setup Assistant.

What’s Next

• Configuración del Gateway
• Uso de la CLI
• Gestión de perfiles remotos
• Guía de extensiones

Seguro que te ha pasado: intentas ejecutar una herramienta de automatización y se rompe porque no encuentra el navegador o intenta abrir uno que no usas. Configurar el control del navegador no debería ser un dolor de cabeza, sobre todo cuando ya tienes instalado tu navegador favorito y solo quieres que funcione.

Si usas Brave o cualquier navegador basado en Chromium, OpenClaw facilita mucho las cosas. Aquí te explico cómo dejarlo listo en pocos minutos.

Requisitos previos

• Un navegador basado en Chromium (Chrome, Brave, Edge, etc.).
• OpenClaw instalado y acceso a su CLI.
• Una cuenta en Browserless (opcional, si prefieres control remoto en la nube).

Inicio rápido

Si tu navegador predeterminado en el sistema ya es Chromium, OpenClaw lo detectará automáticamente. Si prefieres especificar una ruta manual para el ejecutable, usa el siguiente comando en tu CLI:

openclaw config set browser.executablePath "/usr/bin/google-chrome"

También puedes editar directamente tu archivo de configuración según tu sistema operativo:

// macOS
{
  browser: {
    executablePath: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
  }
}

// Windows
{
  browser: {
    executablePath: "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
  }
}

// Linux
{
  browser: {
    executablePath: "/usr/bin/brave-browser"
  }
}

Local vs remote control

OpenClaw te da tres opciones para manejar el navegador:

• Local control (default): El Gateway inicia el servicio de control loopback y lanza un navegador local.
• Remote control (node host): Ejecutas un Node host en la máquina que tiene el navegador; el Gateway envía las acciones del navegador a través de un proxy.
• Remote CDP: Configuras browser.profiles.<name>.cdpUrl (o browser.cdpUrl) para conectarte a un navegador Chromium remoto. En este caso, OpenClaw no lanzará un navegador local.

Las URLs de Remote CDP pueden incluir autenticación:

• Query tokens: https://provider.example?token=<token>
• HTTP Basic auth: https://user:pass@provider.example

OpenClaw mantiene esta autenticación al llamar a los endpoints /json/* y al conectar al WebSocket de CDP. Te recomiendo usar variables de entorno para los tokens en lugar de escribirlos directamente en los archivos de configuración.

Node browser proxy (zero-config default)

Si ejecutas un Node host en la máquina donde está tu navegador, OpenClaw puede rutear automáticamente las llamadas de las herramientas del navegador a ese nodo sin configuración extra. Este es el camino por defecto para Gateways remotos.

Ten en cuenta:

• El Node host expone su servidor de control local mediante un proxy command.
• Los perfiles vienen de la configuración browser.profiles del propio nodo.
• Si quieres desactivarlo:
  • En el nodo: nodeHost.browserProxy.enabled=false
  • En el Gateway: gateway.nodes.browser.mode="off"

Browserless (hosted remote CDP)

Browserless es un servicio de Chromium en la nube que expone endpoints CDP sobre HTTPS. Puedes apuntar un perfil de navegador de OpenClaw a un endpoint regional de Browserless y autenticarte con tu API key.

Ejemplo de configuración:

{
  browser: {
    enabled: true,
    defaultProfile: "browserless",
    remoteCdpTimeoutMs: 2000,
    remoteCdpHandshakeTimeoutMs: 4000,
    profiles: {
      browserless: {
        cdpUrl: "https://production-sfo.browserless.io?token=<BROWSERLESS_API_KEY>",
        color: "#00AA00",
      },
    },
  },
}

No olvides reemplazar <BROWSERLESS_API_KEY> por tu token real y elegir el endpoint regional que corresponda a tu cuenta.

Security

La seguridad es fundamental al automatizar navegadores:

• El control del navegador es solo loopback; el acceso se gestiona mediante la autenticación del Gateway o el emparejamiento de nodos.
• Mantén el Gateway y los Node hosts en una red privada (como Tailscale) y evita exponerlos a internet.
• Maneja las URLs y tokens de Remote CDP como secretos; usa variables de entorno.
• Prefiere endpoints HTTPS y tokens de corta duración.

Profiles (multi-browser)

OpenClaw admite múltiples perfiles con nombre para organizar tus configuraciones de ruteo:

• openclaw-managed: Una instancia dedicada de Chromium con su propio directorio de datos de usuario y puerto CDP.
• remote: Una URL de CDP explícita para un navegador que corre en otro sitio.
• extension relay: Tus pestañas actuales de Chrome mediante el relay local y la extensión de Chrome.

Por defecto, el perfil openclaw se crea automáticamente. El perfil chrome ya viene integrado para el relay de la extensión (apunta a http://127.0.0.1:18792). Los puertos CDP locales se asignan en el rango 18800–18899. Si borras un perfil, sus datos locales se mueven a la papelera.

Para usar un perfil específico en la CLI, añade --browser-profile. En los endpoints de control, usa ?profile=<name>.

Solución de problemas

• El navegador no arranca: Revisa que la ruta en browser.executablePath sea correcta para tu sistema operativo.
• Error de conexión remota: Verifica que el token en la URL de CDP sea válido y que el endpoint HTTPS sea accesible.
• Conflicto de puertos: Si los puertos 18800-18899 están ocupados, OpenClaw podría tener problemas para asignar puertos CDP locales.

¿Necesitas ayuda con una configuración específica? Prueba el AI Setup Assistant.

What’s Next:

• Configuración avanzada del Gateway
• Uso de la extensión de Chrome

Seguro que te ha pasado: quieres automatizar una tarea en el navegador pero odias tener que loguearte de nuevo en cada sitio. Es frustrante cuando una herramienta abre una instancia limpia de Chrome y pierdes tus cookies, tus extensiones favoritas y toda tu configuración personal.

OpenClaw permite que tu agente tome el control de las pestañas que ya tienes abiertas en tu navegador habitual. No necesitas una instancia separada; basta con usar un relay local de CDP y una extensión de Chrome para que todo funcione en tu entorno de siempre.

Requisitos previos

• Gateway ejecutándose localmente o un node host en la máquina donde esté el navegador.
• Google Chrome, Brave, Edge o Chromium instalado.
• OpenClaw CLI configurado en tu terminal.

Inicio rápido

Configura el relay en menos de 5 minutos siguiendo estos pasos:

1. Instala la extensión (modo dev/unpacked): Ejecuta este comando para obtener los archivos:

   openclaw browser extension install

2. Cárgala en tu navegador:

   • Ve a chrome://extensions y activa el “Developer mode”.
   • Haz clic en “Load unpacked” y selecciona el directorio que te indicó el comando openclaw browser extension path.
   • Pincha el icono de la extensión y haz clic sobre él en la pestaña que quieras controlar. El badge cambiará a ON.

3. Ejecuta una prueba desde el CLI:

   openclaw browser --browser-profile chrome tabs

4. Usa el agente: Llama a la tool browser pasando el parámetro profile="chrome".

Si necesitas un nombre distinto o un puerto de relay específico, puedes crear tu propio perfil:

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

Isolation guarantees

Aunque estés usando tu propio navegador, OpenClaw mantiene el orden con estas reglas:

1. Dedicated user data dir: El sistema nunca toca tu perfil personal de navegación.
2. Puertos dedicados: Evita el puerto 9222 para no chocar con tus flujos de trabajo de desarrollo.
3. Control de pestañas determinista: Identifica las pestañas por targetId en lugar de usar “la última pestaña abierta”.
4. Relay manual: El agente solo accede a las pestañas donde tú hagas clic explícitamente en la extensión.

Browser selection

Cuando lanzas el navegador localmente, OpenClaw busca automáticamente en este orden:

1. Chrome
2. Brave
3. Edge
4. Chromium
5. Chrome Canary

Si prefieres usar una ubicación distinta, puedes sobrescribir este comportamiento con browser.executablePath. El sistema busca en las carpetas de aplicaciones estándar en macOS, Linux y Windows.

Control API (opcional)

Para integraciones locales, el Gateway expone una API HTTP en el loopback. Todos los endpoints aceptan el parámetro ?profile=<name>.

• Estado y control: GET /, POST /start, POST /stop
• Gestión de pestañas: GET /tabs, POST /tabs/open, POST /tabs/focus, DELETE /tabs/:targetId
• Capturas: GET /snapshot, POST /screenshot
• Acciones y navegación: POST /navigate, POST /act
• Hooks: POST /hooks/file-chooser, POST /hooks/dialog
• Descargas: POST /download, POST /wait/download
• Debugging: GET /console, POST /pdf, GET /errors, GET /requests, POST /trace/start, POST /trace/stop, POST /highlight
• Estado y Cookies: GET /cookies, POST /cookies/set, POST /cookies/clear
• Storage: GET /storage/:kind, POST /storage/:kind/set, POST /storage/:kind/clear
• Settings: POST /set/offline, POST /set/headers, POST /set/geolocation, POST /set/timezone, POST /set/locale, POST /set/device

Solución de problemas

Sesiones en Sandbox

Si usas sesiones sandboxed, la tool browser podría intentar usar target="sandbox". Como el relay de la extensión necesita controlar el navegador host, tienes dos opciones:

• Ejecuta la sesión sin sandbox.
• Configura agents.defaults.sandbox.browser.allowHostControl: true y usa target="host" al llamar a la tool.

Error de Playwright

Algunas funciones avanzadas (como snapshots de IA, clics complejos o PDFs) requieren Playwright. Si ves el error Playwright is not available in this gateway build, instala el paquete completo de Playwright (no el playwright-core) y reinicia el Gateway.

Instalación en Docker

Si corres el Gateway en Docker, no uses npx playwright. Usa el CLI incluido:

docker compose run --rm openclaw-cli \
  node /app/node_modules/playwright-core/cli.js install chromium

Para que las descargas persistan, configura PLAYWRIGHT_BROWSERS_PATH y asegúrate de que el volumen esté correctamente montado.

¿Necesitas ayuda con la configuración? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Chrome extension deep dive
• Docker deployment guide
• Agent tool reference
• CDP Protocol details

Escribir scripts de automatización para cada pequeña tarea suele ser agotador. A veces solo necesitas entrar al navegador, ver qué está pasando y ejecutar un par de acciones rápidas sin tener que configurar todo un entorno de testing pesado.

La CLI de openclaw está diseñada para que puedas interactuar con el navegador directamente desde tu terminal, manteniendo el control total sin complicaciones innecesarias. Es la herramienta ideal cuando necesitas velocidad y precisión en tus flujos de trabajo.

Requisitos previos

Para empezar a usar estos comandos, asegúrate de cumplir con lo siguiente:

• Tener openclaw instalado y configurado en tu sistema.
• Playwright instalado (necesario si quieres usar el flag --format ai).

Inicio rápido

Sigue estos pasos para interactuar con una página en menos de 5 minutos:

1. Inicia el navegador: openclaw browser start
2. Abre una URL: openclaw browser open https://example.com
3. Captura el estado: openclaw browser snapshot --interactive (esto te dará los IDs o ref de los elementos).
4. Haz clic en un elemento: openclaw browser click 1 (sustituye 1 por el ref que viste en el paso anterior).
5. Cierra todo: openclaw browser stop

Comandos de la CLI

Todos los comandos aceptan --browser-profile <name> para usar un perfil específico y --json si necesitas una salida estructurada para tus scripts.

Basics

Usa estos comandos para la gestión básica de sesiones y pestañas:

openclaw browser status
openclaw browser start
openclaw browser stop
openclaw browser tabs
openclaw browser tab
openclaw browser tab new
openclaw browser tab select 2
openclaw browser tab close 2
openclaw browser open https://example.com
openclaw browser focus abcd1234
openclaw browser close abcd1234

Inspection

Para entender qué está pasando dentro de la página, utiliza las herramientas de inspección:

openclaw browser screenshot
openclaw browser screenshot --full-page
openclaw browser screenshot --ref 12
openclaw browser screenshot --ref e12
openclaw browser snapshot
openclaw browser snapshot --format aria --limit 200
openclaw browser snapshot --interactive --compact --depth 6
openclaw browser snapshot --efficient
openclaw browser snapshot --labels
openclaw browser snapshot --selector "#main" --interactive
openclaw browser snapshot --frame "iframe#main" --interactive
openclaw browser console --level error
openclaw browser errors --clear
openclaw browser requests --filter api --clear
openclaw browser pdf
openclaw browser responsebody "**/api" --max-chars 5000

Actions

Para interactuar con los elementos, necesitas usar los ref obtenidos previamente con snapshot. Ten en cuenta que no se admiten selectores CSS para acciones directas.

openclaw browser navigate https://example.com
openclaw browser resize 1280 720
openclaw browser click 12 --double
openclaw browser click e12 --double
openclaw browser type 23 "hello" --submit
openclaw browser press Enter
openclaw browser hover 44
openclaw browser scrollintoview e12
openclaw browser drag 10 11
openclaw browser select 9 OptionA OptionB
openclaw browser download e12 /tmp/report.pdf
openclaw browser waitfordownload /tmp/report.pdf
openclaw browser upload /tmp/file.pdf
openclaw browser fill --fields '[{"ref":"1","type":"text","value":"Ada"}]'
openclaw browser dialog --accept
openclaw browser wait --text "Done"
openclaw browser wait "#main" --url "**/dash" --load networkidle --fn "window.ready===true"
openclaw browser evaluate --fn '(el) => el.textContent' --ref 7
openclaw browser highlight e12
openclaw browser trace start
openclaw browser trace stop

State

Gestiona cookies, almacenamiento local y condiciones del dispositivo:

openclaw browser cookies
openclaw browser cookies set session abc123 --url "https://example.com"
openclaw browser cookies clear
openclaw browser storage local get
openclaw browser storage local set theme dark
openclaw browser storage session clear
openclaw browser set offline on
openclaw browser set headers --json '{"X-Debug":"1"}'
openclaw browser set credentials user pass
openclaw browser set credentials --clear
openclaw browser set geo 37.7749 -122.4194 --origin "https://example.com"
openclaw browser set geo --clear
openclaw browser set media dark
openclaw browser set timezone America/New_York
openclaw browser set locale en-US
openclaw browser set device "iPhone 14"

Notas importantes sobre el uso

• Comandos de “Armado”: Los comandos upload y dialog deben ejecutarse antes de la acción (clic o pulsación de tecla) que dispara el selector de archivos o el diálogo.
• Subida de archivos: upload también permite configurar inputs de archivos directamente usando --input-ref o --element.
• Snapshot y Referencias:
  • --format ai: Es el valor por defecto si Playwright está instalado. Devuelve refs numéricos (aria-ref="<n>").
  • --format aria: Devuelve el árbol de accesibilidad sin refs (solo para inspección).
  • --efficient: Un ajuste predeterminado compacto (interactive + compact + depth + menos caracteres). Puedes configurarlo por defecto en el Gateway con browser.snapshotDefaults.mode: "efficient".
  • --interactive: Genera una lista plana de elementos interactivos, ideal para elegir el ref de una acción.
  • --labels: Genera una captura de pantalla con etiquetas visuales de los ref.

Solución de problemas

• El comando de clic no abre el selector de archivos: Asegúrate de ejecutar openclaw browser upload justo antes del comando click. Estos comandos funcionan “armando” el navegador para la siguiente interacción.
• No puedo usar selectores CSS en los comandos de acción: Esto es por diseño para garantizar la fiabilidad. Primero ejecuta un snapshot para obtener el ref numérico (ej. 12) o de rol (ej. e12) y úsalo en tu comando de click o type.
• El snapshot no muestra los elementos que necesito: Prueba a usar el flag --interactive o aumenta la profundidad con --depth para encontrar elementos anidados en el DOM.
• Error al usar —format ai: Verifica que Playwright esté correctamente instalado en tu entorno, ya que es una dependencia necesaria para este formato específico.

Si necesitas ayuda personalizada para configurar tu entorno, consulta nuestro AI Setup Assistant.

Próximos pasos

• Configuración de Gateway
• Guía avanzada de snapshots

---
title: "Snapshots y refs: Automatización estable en OpenClaw"
description: "Aprende a interactuar con el navegador usando snapshots de texto y referencias estables para evitar selectores frágiles."
---

¿Alguna vez has escrito un script de automatización que se rompe al día siguiente porque cambiaron un `id` o una `class` en el HTML? Es frustrante intentar que un agente entienda qué botón presionar cuando el DOM es un caos de divs anidados y nombres de clases generados aleatoriamente.

En lugar de pelear con selectores CSS complejos, OpenClaw utiliza un sistema de snapshots que convierte la interfaz de usuario en algo legible tanto para ti como para el agente. Esto permite que las interacciones sean deterministas y mucho menos propensas a fallos.

## Requisitos previos

- Acceso al CLI de `openclaw`.
- Un Browser profile configurado.
- Node.js instalado para ejecutar el entorno.

## Inicio rápido

Sigue estos pasos para interactuar con cualquier página en menos de 5 minutos:

1. **Genera un snapshot**: Ejecuta `openclaw browser snapshot`. Verás una lista de texto con números (refs).
2. **Identifica el ref**: Busca el elemento que necesitas (por ejemplo, un botón con el ref `12`).
3. **Ejecuta la acción**: Usa el comando `openclaw browser click 12`.
4. **Prueba el modo interactivo**: Si necesitas más detalle, usa `openclaw browser snapshot --interactive` para obtener refs basados en roles (como `e12`).

## Snapshots y refs

OpenClaw soporta dos estilos de "snapshot" para adaptarse a tus necesidades:

- **AI snapshot (refs numéricos)**: Es el formato por defecto (`--format ai`).
  - **Output**: Un snapshot de texto que incluye refs numéricos.
  - **Acciones**: `openclaw browser click 12`, `openclaw browser type 23 "hello"`.
  - Internamente, el ref se resuelve mediante el `aria-ref` de Playwright.

- **Role snapshot (refs de rol como `e12`)**: Se activa con `openclaw browser snapshot --interactive`.
  - **Output**: Una lista o árbol basado en roles con `[ref=e12]` (y opcionalmente `[nth=1]`).
  - **Acciones**: `openclaw browser click e12`, `openclaw browser highlight e12`.
  - Puedes añadir `--labels` para incluir una captura de pantalla del viewport con etiquetas `e12` superpuestas.
  - Soporta flags adicionales como `--compact`, `--depth`, `--selector` o `--frame`.

**Comportamiento de los refs:**
- Los refs **no son estables entre navegaciones**. Si algo falla, vuelve a ejecutar `snapshot` y usa un ref nuevo.
- Si tomaste un role snapshot con `--frame`, los refs de rol están limitados a ese iframe hasta el siguiente snapshot de rol.

## Wait power-ups

No te limites a esperar por tiempo o texto. Puedes usar condiciones más potentes:

- **Esperar por URL** (soporta globs de Playwright): `openclaw browser wait --url "**/dash"`
- **Esperar estado de carga**: `openclaw browser wait --load networkidle`
- **Esperar predicado de JS**: `openclaw browser wait --fn "window.ready===true"`
- **Esperar selector visible**: `openclaw browser wait "#main"`

Puedes combinar estas opciones en un solo comando:

```bash
openclaw browser wait "#main" \
  --url "**/dash" \
  --load networkidle \
  --fn "window.ready===true" \
  --timeout-ms 15000

Debug workflows

Cuando una acción falla (por ejemplo, errores de “not visible” o “strict mode violation”), te recomiendo este flujo:

1. Ejecuta openclaw browser snapshot --interactive.
2. Usa click <ref> o type <ref> (es preferible usar role refs en modo interactivo).
3. Si sigue fallando: openclaw browser highlight <ref> para ver qué está intentando tocar Playwright.
4. Si la página se comporta de forma extraña, revisa logs:
   • openclaw browser errors --clear
   • openclaw browser requests --filter api --clear
5. Para un análisis profundo, graba un trace:
   • openclaw browser trace start, reproduce el error y luego openclaw browser trace stop.

Salida JSON

Si estás creando scripts o herramientas estructuradas, usa el flag --json.

Ejemplos:

openclaw browser status --json
openclaw browser snapshot --interactive --json
openclaw browser requests --filter api --json
openclaw browser cookies --json

Los role snapshots en JSON incluyen los refs y un bloque de stats (líneas, caracteres, interactividad) para que tus herramientas puedan calcular el tamaño del payload.

Ajustes de estado y entorno

Usa estos comandos para que el sitio se comporte exactamente como necesitas:

• Cookies y Storage: cookies set, storage local set, o cookies clear.
• Conectividad: set offline on|off.
• Headers y Auth: set headers --json '{"X-Debug":"1"}' o set credentials user pass.
• Geolocalización: set geo <lat> <lon> --origin "https://example.com".
• Dispositivo y Viewport:
  • set device "iPhone 14" (usa presets de Playwright).
  • set viewport 1280 720.
• Media y Localización: set media dark|light, set timezone ..., set locale ....

Seguridad y privacidad

• El perfil del navegador de OpenClaw puede contener sesiones activas; trátalo como información sensible.
• Los comandos openclaw browser evaluate y wait --fn ejecutan JavaScript arbitrario. Si te preocupa el Prompt Injection, desactívalo con browser.evaluateEnabled=false.
• Mantén el Gateway o el host de Node.js privado (usa loopback o tailnet).
• Protege los endpoints remotos de CDP mediante túneles.

Solución de problemas

• Problemas en Linux: Si tienes errores con Chromium (especialmente en versiones snap), consulta la guía de Browser troubleshooting.
• Refs inválidos: Si el elemento no responde, recuerda que los refs cambian al navegar o recargar la página.
• Acciones bloqueadas: Usa highlight para verificar si otro elemento está cubriendo tu objetivo.
• Sesiones caducadas: Si los comandos fallan en sitios con login, revisa Browser login + X/Twitter posting.

Agent tools: Cómo funciona el control

El agente utiliza una única herramienta llamada browser para gestionar todo el flujo (status, start, stop, snapshot, act, etc.).

• browser snapshot devuelve un árbol de UI estable.
• browser act utiliza los IDs de ref del snapshot para realizar acciones como click o type.
• Puedes especificar el target (sandbox, host o node) para decidir dónde se ejecuta el navegador.
• Si usas target: "host" en una sesión sandboxed, asegúrate de tener agents.defaults.sandbox.browser.allowHostControl=true.

¿Tienes dudas sobre la configuración? Prueba nuestro AI Setup Assistant.

What’s Next:

• Browser login + X/Twitter posting
• Browser troubleshooting en Linux