Behebung der Fehler 'Navigate Unsupported' und Browser-Plugin bei selbst gehostetem OpenClaw auf Docker

Wenn Sie OpenClaw auf einer VPS (z. B. Hostinger) selbst hosten und Ihr Agent nicht im Web surfen kann, liegt das Problem wahrscheinlich an einer Mischung aus Root-Berechtigungen, fehlenden Chromium-Binärdateien und einer Playwright-Versionsinkompatibilität. Hier ist die genaue Lösung, die von "Navigate Unsupported" zu funktionierenden Google-Screenshots geführt hat.

1. Berechtigungshürde (EACCES)

Überprüfen Sie die Logs mit docker logs [container-name]. Wenn Sie npm error Error: EACCES: permission denied, mkdir sehen, kann der Container keinen node_modules-Ordner erstellen. Beheben Sie dies, indem Sie user: root und init: true zu Ihrem docker-compose.yml unter dem openclaw-Service hinzufügen:

services:
  openclaw:
    image: ghcr.io/hostinger/hvps-openclaw:latest
    user: root    # <-- die Lösung
    init: true

2. Anbinden der Browserless-Engine

Fügen Sie einen browserless-Service hinzu, um Seiten zu rendern:

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

Setzen Sie diese Umgebungsvariable im OpenClaw-Service:

BROWSERLESS_URL=ws://browserless:3000?token=[IHR-EIGENES-TOKEN]

3. Die 'Navigate Unsupported'-Lösung

Der Fehler bedeutet, dass Playwright fehlt. Installieren Sie die genaue Version, die das Plugin erwartet, in dessen Ordner:

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

4. Chromium-Binärdateien herunterladen

Die Bibliothek allein reicht nicht; Sie benötigen die eigentlichen Chromium-Binärdateien (ca. 170 MB):

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

5. Alles verknüpfen

Führen Sie das Diagnosetool aus und erstellen Sie einen symbolischen Link, damit OpenClaws Gateways Playwright finden:

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

Verlinken Sie dann manuell die Playwright-Installation in das Hauptverzeichnis von OpenClaw. Nach einem Neustart sollte der Fehler verschwinden.

Wenn Ihr Agent sich immer wieder entschuldigt, dass er das Web nicht sehen kann, folgen Sie diesen Schritten in der Reihenfolge: Root-Benutzer, Browserless, korrekte Playwright-Version, Chromium-Binärdateien und die Doctor-Fix.