Solución de problemas del navegador

Solución de problemas del navegador (Linux)

Problema: “Failed to start Chrome CDP on port 18800”

El servidor de control del navegador de OpenClaw no logra iniciar Chrome/Brave/Edge/Chromium con el error:

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

Causa raíz

En Ubuntu (y muchas distribuciones de Linux), la instalación predeterminada de Chromium es un paquete snap. El confinamiento de AppArmor de Snap interfiere con la forma en que OpenClaw genera y monitorea el proceso del navegador.

El comando apt install chromium instala un paquete stub que redirige a snap:

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

Esto NO es un navegador real; es solo un contenedor.

Solución 1: Instalar Google Chrome (Recomendado)

Instale el paquete .deb oficial de Google Chrome, que no está sandboxed por snap:

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

Luego actualice su configuración de OpenClaw (~/.openclaw/openclaw.json):

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

Solución 2: Usar Snap Chromium con el modo de solo conexión

Si debe usar snap Chromium, configure OpenClaw para adjuntarse a un navegador iniciado manualmente:

1. Actualizar configuración:

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

2. Iniciar Chromium manualmente:

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

3. Opcionalmente, cree un servicio de usuario systemd para iniciar Chrome automáticamente:

~/.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

Habilitar con: systemctl --user enable --now openclaw-browser.service

Verificar que el navegador funciona

Verificar estado:

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

Probar navegación:

curl -s -X POST http://127.0.0.1:18791/start
curl -s http://127.0.0.1:18791/tabs

Referencia de configuración

Opción	Descripción	Predeterminado
browser.enabled	Habilitar el control del navegador	true
browser.executablePath	Ruta al binario de un navegador basado en Chromium (Chrome/Brave/Edge/Chromium)	autodetectado (prefiere el navegador predeterminado cuando está basado en Chromium)
browser.headless	Ejecutar sin GUI	false
browser.noSandbox	Añadir el indicador --no-sandbox (necesario para algunas configuraciones de Linux)	false
browser.attachOnly	No iniciar el navegador, solo adjuntarse al existente	false
browser.cdpPort	Puerto del Protocolo de Chrome DevTools	18800

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

Estás utilizando un perfil existing-session / Chrome MCP. OpenClaw puede ver el Chrome local, pero no hay pestañas abiertas disponibles para adjuntar.

Opciones de solución:

1. Use el navegador administrado: openclaw browser start --browser-profile openclaw (o configure browser.defaultProfile: "openclaw").
2. Use Chrome MCP: asegúrese de que Chrome local se esté ejecutando con al menos una pestaña abierta, luego reintente con --browser-profile user.

Notas:

• user es solo para el host. Para servidores Linux, contenedores o hosts remotos, prefiera los perfiles CDP.
• Los perfiles openclaw locales asignan automáticamente cdpPort/cdpUrl; solo configure esos para CDP remoto.