OpenClawSkills
GitHub
Referencia CLI • 5 min de lectura

Navegador

Referencia CLI para openclaw browser (perfiles, pestañas, acciones, relay de extensión).

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

Relacionado:

- Herramienta de navegador + API: ''Herramienta Navegador''

- Relay de extensión Chrome: ''Extensión Chrome''

Tutorial.step

Flags comunes

- ''--url <gatewayWsUrl>'': URL WebSocket del Gateway (predeterminado desde configuración).

- ''--token <token>'': Token del Gateway (si es requerido).

- ''--timeout <ms>'': Tiempo de espera de petición (milisegundos).

- ''--browser-profile <nombre>'': Seleccionar perfil de navegador (predeterminado desde configuración).

- ''--json'': Salida legible por máquina (si es soportado).

Tutorial.step

Inicio rápido (local)

Bash
openclaw browser --browser-profile chrome tabs
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot
Tutorial.step

Perfiles

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

- ''openclaw'': Lanza/adjunta a una instancia de Chrome dedicada gestionada por OpenClaw (directorio de datos de usuario aislado).

- ''chrome'': Controla tus pestañas de Chrome existentes vía relay de extensión Chrome.

Bash
openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser delete-profile --name work

Usar un perfil específico:

Bash
openclaw browser --browser-profile work tabs
Tutorial.step

Pestañas

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

Snapshot/Captura/Acciones

Snapshot:

Bash
openclaw browser snapshot

Captura de pantalla:

Bash
openclaw browser screenshot

Navegar/Clic/Escribir (automatización UI basada en ref):

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

Relay de extensión Chrome (adjuntar vía botón de toolbar)

Este modo permite a los agentes controlar pestañas de Chrome existentes que adjuntas manualmente (no se auto-adjunta).

Instalar extensión desempaquetada en una ruta estable:

Bash
openclaw browser extension install
openclaw browser extension path

Luego Chrome → ''chrome://extensions'' → Habilitar "Modo desarrollador" → "Cargar desempaquetado" → Seleccionar carpeta impresa.

Guía completa: ''Extensión Chrome''

Tutorial.step

Control de navegador remoto (proxy de node host)

Si el gateway se ejecuta en una máquina diferente al navegador, ejecuta un node host en la máquina con Chrome/Brave/Edge/Chromium. El gateway hará proxy de acciones del navegador a ese nodo (no se necesita servidor de control de navegador separado).

Si múltiples nodos están conectados, usa ''gateway.nodes.browser.mode'' para controlar auto-enrutamiento y ''gateway.nodes.browser.node'' para fijar un nodo específico.

Seguridad + configuración remota: ''Herramienta Navegador'', ''Acceso Remoto'', ''Tailscale'', ''Seguridad''