Solución de problemas del navegador

​

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

{ "error": "Error: No se pudo iniciar Chrome CDP en el puerto 18800 para el perfil \"openclaw\"." }

​

Causa raíz

Nota: se selecciona 'chromium-browser' en lugar de 'chromium'
chromium-browser ya es la versión más reciente (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 vuelve a intentarlo una vez cuando el bloqueo apunta a un proceso inactivo 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 usan de forma alternativa el modo sin interfaz gráfica en Linux cuando DISPLAY y WAYLAND_DISPLAY no están definidos. Si se ha definido OPENCLAW_BROWSER_HEADLESS=0, browser.headless: false o browser.profiles.<name>.headless: false, elimine esa configuración que fuerza el modo con interfaz gráfica, defina OPENCLAW_BROWSER_HEADLESS=1, inicie Xvfb, ejecute openclaw browser start --headless para realizar un inicio administrado único, 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.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt --fix-broken install -y  # si hay errores de dependencias

{
  "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

{
  "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=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: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 profile=“user”

1. Use en su lugar el navegador administrado: openclaw browser --browser-profile openclaw start (o defina 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.

• user solo funciona en el host. En servidores Linux, contenedores o hosts remotos, se recomienda usar perfiles CDP.
• user y otros perfiles existing-session comparten las limitaciones actuales de Chrome MCP: solo acciones basadas en referencias, un archivo por carga, sin sustituciones de timeoutMs en cuadros de diálogo, 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; establézcalos manualmente solo para CDP remoto.
• Los perfiles CDP remotos aceptan http://, https://, ws:// y wss://. Use HTTP(S) para la detección de /json/version, o WS(S) cuando el servicio del navegador proporcione una URL directa del socket de DevTools.

​

Contenido relacionado

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