Corrección de errores de 'Navegación no compatible' y complementos del navegador en OpenClaw autogestionado en Docker

Si estás autoalojando OpenClaw en un VPS (ej., Hostinger) y tu agente no puede navegar por la web, el problema probablemente es una combinación de permisos de root, falta de binarios de Chromium y una versión incorrecta de Playwright. Aquí está la solución exacta para pasar de "Navigate Unsupported" a capturas de pantalla de Google funcionales.

1. Muro de permisos (EACCES)

Revisa los registros con docker logs [nombre-contenedor]. Si ves npm error Error: EACCES: permission denied, mkdir, el contenedor no puede crear node_modules. Solución: añade user: root e init: true a tu docker-compose.yml bajo el servicio openclaw:

services:
  openclaw:
    image: ghcr.io/hostinger/hvps-openclaw:latest
    user: root    # <-- la solución
    init: true

2. Conexión del motor Browserless

Añade un servicio browserless para renderizar páginas:

  browserless:
    image: ghcr.io/browserless/chromium:latest
    ports:
      - "3000:3000"
    environment:
      - CONCURRENT=5
      - TOKEN=[TU-TOKEN-PERSONALIZADO]

Configura esta variable de entorno en el servicio OpenClaw:

BROWSERLESS_URL=ws://browserless:3000?token=[TU-TOKEN-PERSONALIZADO]

3. Solución para 'Navigate Unsupported'

El error significa que falta Playwright. Instala forzosamente la versión exacta que espera el plugin en su carpeta:

docker exec -u root -it [nombre-contenedor] bash -c "npm install [email protected] --prefix /usr/local/lib/node_modules/openclaw/dist/extensions/browser"

4. Descargar binarios de Chromium

La biblioteca sola no basta; necesitas los binarios reales de Chromium (unos 170MB):

docker exec -u root -it [nombre-contenedor] npx playwright install chromium

5. Vincular todo

Ejecuta la herramienta de diagnóstico y crea un enlace simbólico para que las puertas de enlace de OpenClaw encuentren Playwright:

docker exec -u root -it [nombre-contenedor] openclaw doctor --fix

Luego, crea manualmente un enlace simbólico de la instalación de Playwright al directorio principal de OpenClaw. Tras reiniciar, el error debería desaparecer.

Si tu agente sigue disculpándose por no poder ver la web, sigue estos pasos en orden: usuario root, browserless, versión correcta de Playwright, binarios de Chromium y el comando doctor.