Solución de problemas del navegador

Problema: no se pudo iniciar Chrome CDP en el puerto 18800

{ "error": "Error: Failed to start Chrome CDP on port 18800 for profile \"openclaw\"." }

Causa raíz

En Ubuntu y en la mayoría de las distribuciones de Linux, apt install chromium instala un envoltorio de snap, no un navegador real:

Note, selecting 'chromium-browser' instead of 'chromium'chromium-browser is already the newest version (2:1snap1-0ubuntu2).

El confinamiento de AppArmor de snap interfiere en la forma en que OpenClaw inicia y supervisa el proceso del navegador.

Otros fallos habituales al iniciar en Linux:

• The profile appears to be in use by another Chromium process: hay archivos de bloqueo Singleton* obsoletos en el directorio del perfil administrado. OpenClaw elimina estos bloqueos y reintenta una vez cuando el bloqueo apunta a un proceso finalizado o de otro host.
• Missing X server or $DISPLAY: se solicitó explícitamente un navegador visible en un host sin sesión de escritorio. Los perfiles locales administrados cambian al modo sin interfaz gráfica en Linux cuando tanto DISPLAY como WAYLAND_DISPLAY están sin definir. Si establece OPENCLAW_BROWSER_HEADLESS=0, browser.headless: false o browser.profiles.<name>.headless: false, elimine esa anulación del modo con interfaz, establezca OPENCLAW_BROWSER_HEADLESS=1, inicie Xvfb, ejecute openclaw browser start --headless para realizar un único inicio administrado o ejecute OpenClaw en una sesión de escritorio real.

Solución 1: instalar Google Chrome (recomendado)

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.debsudo dpkg -i google-chrome-stable_current_amd64.debsudo apt --fix-broken install -y  # si hay errores de dependencias

Actualice ~/.openclaw/openclaw.json:

{  "browser": {    "enabled": true,    "executablePath": "/usr/bin/google-chrome-stable",    "headless": true,    "noSandbox": true  }}

Solución 2: usar Chromium de snap en modo de solo conexión

Si debe conservar Chromium de snap, configure OpenClaw para que se conecte a un navegador iniciado manualmente en lugar de iniciarlo:

{  "browser": {    "enabled": true,    "attachOnly": true,    "headless": true,    "noSandbox": true  }}

Inicie Chromium manualmente:

chromium-browser --headless --no-sandbox --disable-gpu \  --remote-debugging-port=18800 \  --user-data-dir=$HOME/.openclaw/browser/openclaw/user-data \  about:blank &

Opcionalmente, configúrelo para que se inicie automáticamente mediante un servicio de usuario de systemd:

# ~/.config/systemd/user/openclaw-browser.service[Unit]Description=Navegador de OpenClaw (Chrome CDP)After=network.target [Service]ExecStart=/snap/bin/chromium --headless --no-sandbox --disable-gpu --remote-debugging-port=18800 --user-data-dir=%h/.openclaw/browser/openclaw/user-data about:blankRestart=on-failureRestartSec=5 [Install]WantedBy=default.target

systemctl --user enable --now openclaw-browser.service

Verificar que el navegador funciona

curl -s http://127.0.0.1:18791/ | jq '{running, pid, chosenBrowser}'curl -s -X POST http://127.0.0.1:18791/startcurl -s http://127.0.0.1:18791/tabs

Referencia de configuración

Ambos valores de tiempo de espera deben ser enteros positivos de hasta 120000 ms; los demás valores se rechazan al cargar la configuración. En Raspberry Pi, hosts VPS antiguos o sistemas con almacenamiento lento, aumente browser.localLaunchTimeoutMs cuando Chrome necesite más tiempo para exponer su punto de conexión HTTP de CDP. Aumente browser.localCdpReadyTimeoutMs cuando el inicio se complete correctamente, pero openclaw browser start siga indicando not reachable after start.

Problema: no se encontraron pestañas de Chrome para profile="user"

Está usando el perfil user (existing-session / Chrome MCP) y no hay ninguna pestaña abierta a la que conectarse.

Opciones para solucionarlo:

1. Use en su lugar el navegador administrado: openclaw browser --browser-profile openclaw start (o establezca browser.defaultProfile: "openclaw").
2. Mantenga Chrome local en ejecución con al menos una pestaña abierta y vuelva a intentarlo con --browser-profile user.

Notas:

• user solo funciona en el host. En servidores Linux, contenedores o hosts remotos, use preferentemente perfiles CDP.
• user y los demás perfiles existing-session comparten las limitaciones actuales de Chrome MCP: solo acciones basadas en referencias, un archivo por carga, sin anulaciones de timeoutMs para diálogos, sin wait --load networkidle y sin responsebody, exportación a PDF, interceptación de descargas ni acciones por lotes.
• Los perfiles locales del controlador openclaw asignan automáticamente cdpPort/cdpUrl; solo establézcalos manualmente para CDP remoto.
• Los perfiles CDP remotos admiten http://, https://, ws:// y wss://. Use HTTP(S) para detectar /json/version, o WS(S) cuando su servicio de navegador le proporcione una URL directa del socket de DevTools.

Contenido relacionado

• Navegador
• Inicio de sesión en el navegador
• Solución de problemas de WSL2 del navegador