Domina el navegador con OpenClaw CLI: Guía de comandos

¿Alguna vez has sentido que automatizar un navegador es más difícil de lo que debería? Entre configurar drivers y gestionar sesiones, es fácil perder el hilo y terminar con un entorno desordenado.

OpenClaw te permite tomar el control total de tu navegador directamente desde la terminal, simplificando tareas como capturas de pantalla o navegación automatizada sin complicaciones innecesarias.

openclaw browser

Gestiona el servidor de control del navegador de OpenClaw y ejecuta acciones (pestañas, snapshots, capturas de pantalla, navegación, clics, escritura).

Relacionado:

• Herramienta de Browser + API: Browser tool

Flags comunes

• --url <gatewayWsUrl>: URL del WebSocket del Gateway (por defecto usa la de la configuración).
• --token <token>: Token del Gateway (si es necesario).
• --timeout <ms>: Tiempo de espera de la solicitud (ms).
• --browser-profile <name>: Elige un perfil de navegador (por defecto usa el de la configuración).
• --json: Salida en formato legible para máquinas (donde sea compatible).

Inicio rápido (local)

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

Si el comando no aparece

Si openclaw browser es un comando desconocido, revisa plugins.allow en ~/.openclaw/openclaw.json.

Cuando plugins.allow está presente, el plugin de navegador integrado debe aparecer explícitamente en la lista:

{
  plugins: {
    allow: ["telegram", "browser"],
  },
}

Ten en cuenta que browser.enabled=true no restaura el subcomando de la CLI si la lista de permitidos del plugin excluye a browser.

Relacionado: Browser tool

Perfiles

Los perfiles son configuraciones de enrutamiento del navegador con nombre. En la práctica:

• openclaw: Lanza o se conecta a una instancia de Chrome dedicada y gestionada por OpenClaw (con un directorio de datos de usuario aislado).
• user: Controla tu sesión actual de Chrome con la que ya has iniciado sesión a través de Chrome DevTools MCP.
• Perfiles CDP personalizados: Apuntan a un endpoint CDP local o remoto.

openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser create-profile --name chrome-live --driver existing-session
openclaw browser delete-profile --name work

Usa un perfil específico:

openclaw browser --browser-profile work tabs

Pestañas

openclaw browser tabs
openclaw browser open https://docs.openclaw.ai
openclaw browser focus <targetId>
openclaw browser close <targetId>

Snapshot / captura de pantalla / acciones

Snapshot:

openclaw browser snapshot

Captura de pantalla:

openclaw browser screenshot

Navegar/clic/escribir (automatización de UI basada en referencias):

openclaw browser navigate https://example.com
openclaw browser click <ref>
openclaw browser type <ref> "hello"

Chrome existente vía MCP

Usa el perfil user integrado o crea tu propio perfil existing-session:

openclaw browser --browser-profile user tabs
openclaw browser create-profile --name chrome-live --driver existing-session
openclaw browser create-profile --name brave-live --driver existing-session --user-data-dir "~/Library/Application Support/BraveSoftware/Brave-Browser"
openclaw browser --browser-profile chrome-live tabs

Esta ruta es solo para el host. Para Docker, servidores headless, Browserless u otras configuraciones remotas, usa un perfil CDP en su lugar.

Control remoto del navegador (node host proxy)

Si el Gateway se ejecuta en una máquina diferente a la del navegador, inicia un node host en la máquina que tenga Chrome/Brave/Edge/Chromium. El Gateway enviará las acciones del navegador a ese nodo (no se requiere un servidor de control de navegador por separado).

Usa gateway.nodes.browser.mode para controlar el enrutamiento automático y gateway.nodes.browser.node para fijar un nodo específico si hay varios conectados.

Seguridad y configuración remota: Browser tool, Remote access, Tailscale, Security

Próximos pasos

• Aprende más sobre la Browser tool
• Configura el Acceso remoto
• Revisa las opciones de Seguridad

AI Setup Assistant