자체 호스팅 오픈클로 도커에서 '지원되지 않는 탐색' 및 브라우저 플러그인 오류 수정

VPS(예: Hostinger)에서 OpenClaw를 자체 호스팅하는데 에이전트가 웹을 탐색할 수 없다면, 문제는 대개 root 권한, Chromium 바이너리 누락, Playwright 버전 불일치의 조합입니다. 다음은 "Navigate Unsupported"에서 작동하는 Google 스크린샷으로 전환하는 데 사용된 정확한 수정 방법입니다.

1. 권한 문제 (EACCES)

docker logs [컨테이너 이름]으로 로그를 확인하세요. npm error Error: EACCES: permission denied, mkdir이 보이면 컨테이너가 node_modules를 생성할 수 없는 것입니다. docker-compose.yml의 openclaw 서비스에 user: root와 init: true를 추가하여 해결하세요:

services:
  openclaw:
    image: ghcr.io/hostinger/hvps-openclaw:latest
    user: root    # <-- 해결 방법
    init: true

2. Browserless 엔진 연결

페이지를 렌더링하기 위해 browserless 서비스를 추가하세요:

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

OpenClaw 서비스에 다음 환경 변수를 설정하세요:

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

3. 'Navigate Unsupported' 해결

이 오류는 Playwright가 누락되었음을 의미합니다. 플러그인이 기대하는 정확한 버전을 해당 폴더에 강제 설치하세요:

docker exec -u root -it [컨테이너 이름] bash -c "npm install [email protected] --prefix /usr/local/lib/node_modules/openclaw/dist/extensions/browser"

4. Chromium 바이너리 다운로드

라이브러리만으로는 충분하지 않습니다. 실제 Chromium 바이너리(약 170MB)가 필요합니다:

docker exec -u root -it [컨테이너 이름] npx playwright install chromium

5. 모두 연결

진단 도구를 실행하고 OpenClaw의 게이트웨이가 Playwright를 찾을 수 있도록 심볼릭 링크를 생성하세요:

docker exec -u root -it [컨테이너 이름] openclaw doctor --fix

그런 다음 Playwright 설치를 기본 OpenClaw 디렉토리에 수동으로 심볼릭 링크하세요. 재시작 후 오류가 사라집니다.

에이전트가 계속 웹을 볼 수 없다고 말한다면, 다음 단계를 순서대로 따르세요: root 사용자, browserless, 올바른 Playwright 버전, Chromium 바이너리, doctor 수정.