Fixing 'Navigate Unsupported' and Browser Plugin Errors in Self-Hosted OpenClaw on Docker

If you're self-hosting OpenClaw on a VPS (e.g., Hostinger) and your agent can't browse the web, the problem is likely a mix of root permissions, missing Chromium binaries, and a Playwright version mismatch. Here's the exact fix used to go from "Navigate Unsupported" to working Google screenshots.

1. Permission Wall (EACCES)

Check logs with docker logs [container-name]. If you see npm error Error: EACCES: permission denied, mkdir, the container can't create node_modules. Fix by adding user: root and init: true to your docker-compose.yml under the openclaw service:

services:
  openclaw:
    image: ghcr.io/hostinger/hvps-openclaw:latest
    user: root    # <-- the fix
    init: true

2. Wiring the Browserless Engine

Add a browserless service to render pages:

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

Set this environment variable on the OpenClaw service:

BROWSERLESS_URL=ws://browserless:3000?token=[YOUR-CUSTOM-TOKEN]

3. The 'Navigate Unsupported' Fix

The error means Playwright is missing. Force-install the exact version the plugin expects into its folder:

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

4. Download Chromium Binaries

The library alone isn't enough; you need actual Chromium binaries (about 170MB):

docker exec -u root -it [container-name] npx playwright install chromium

5. Link Everything

Run the diagnostic tool and create a symlink so OpenClaw's gateways can find Playwright:

docker exec -u root -it [container-name] openclaw doctor --fix

Then manually symlink the Playwright install into the main OpenClaw directory. After a restart, the error should vanish.

If your agent keeps apologizing about not seeing the web, follow these steps in order: root user, browserless, correct Playwright version, Chromium binaries, and the doctor fix.