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

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

• The profile appears to be in use by another Chromium process: 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 muerto o de otro host.
• Missing X server or $DISPLAY: se solicitó explícitamente un navegador visible en un host sin una sesión de escritorio. Los perfiles administrados locales recurren al modo sin interfaz en Linux cuando tanto DISPLAY como WAYLAND_DISPLAY no están definidos. Si configuras OPENCLAW_BROWSER_HEADLESS=0, browser.headless: false o browser.profiles.<name>.headless: false, elimina esa anulación con interfaz, configura OPENCLAW_BROWSER_HEADLESS=1, inicia Xvfb, ejecuta openclaw browser start --headless para un inicio administrado único, o ejecuta 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.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt --fix-broken install -y  # if there are dependency errors

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

​

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

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

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

# ~/.config/systemd/user/openclaw-browser.service
[Unit]
Description=OpenClaw Browser (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:blank
Restart=on-failure
RestartSec=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/start
curl -s http://127.0.0.1:18791/tabs

​

Referencia de configuración

​

Problema: no se encontraron pestañas de Chrome para el perfil=“user”

1. Usa el navegador administrado en su lugar: openclaw browser --browser-profile openclaw start (o configura browser.defaultProfile: "openclaw").
2. Mantén Chrome local en ejecución con al menos una pestaña abierta y luego reintenta con --browser-profile user.

• user es solo para el host. En servidores Linux, contenedores o hosts remotos, prefiere perfiles CDP.
• user y otros perfiles existing-session comparten los límites 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 de controlador openclaw locales asignan automáticamente cdpPort/cdpUrl; configúralos manualmente solo para CDP remoto.
• Los perfiles CDP remotos aceptan http://, https://, ws:// y wss://. Usa HTTP(S) para el descubrimiento de /json/version, o WS(S) cuando tu servicio de navegador te proporcione una URL directa de socket DevTools.

​

Relacionado

• Navegador
• Inicio de sesión del navegador
• Solución de problemas de Browser WSL2 con CDP remoto de Windows