많은 분들이 서버에 OpenClaw을 개인 AI 어시스턴트로 배포하지만, 기본 설정만으로는 OpenClaw이 웹페이지에 접근할 수 없습니다. 웹을 자유롭게 탐색해야 하는 AI 어시스턴트라면 가장 큰 제약이 될 만한 부분입니다.
다행히 헤드리스 브라우저(Headless Browser)를 설정하면 OpenClaw에 웹페이지 접근, 스크린샷 촬영, 자동화 작업 수행 등의 기능을 부여할 수 있습니다. 이 글에서는 ARM64 아키텍처 서버에서 전체 설정 과정을 자세히 안내합니다.
왜 브라우저가 필요한가
OpenClaw 자체는 AI 어시스턴트 프레임워크이므로, 사용자 대신 “똑똑하게” 일을 돕게 하려면 브라우저 기능이 필수입니다.
- 실시간 정보 수집: 날씨, 뉴스, 주식 등
- 웹 자동화: 자동 양식 입력, 클릭 작업, 정기 체크인
- 콘텐츠 스크린샷: 웹페이지 스크린샷을 사용자에게 전송
- 크롤링: 특정 웹사이트의 콘텐츠 수집
ARM64의 딜레마
시장에 배포되는 Chrome 브라우저에는 amd64 아키텍처 버전만 있으며, 많은 분들이 Apple Silicon Mac이나 ARM 서버(예: Tencent Cloud Lighthouse)를 사용합니다. 그 탓에 일반적인 Chrome 설치 방식은 사용할 수 없습니다.
해결책은 두 가지입니다.
- Snap Chromium 사용: Ubuntu에 기본 제공되지만 설정이 번거롭습니다
- Playwright Chromium 사용: 크로스 플랫폼이며 ARM64를 지원합니다
이 글에서는 더 통제하기 쉬운 2번 방법을 선택합니다.
기술 스택
| 구성 요소 | 역할 | 비고 |
|---|---|---|
| Playwright | 브라우저 자동화 프레임워크 | Chromium 바이너리 제공 |
| Chromium | 헤드리스 브라우저 | ARM64 호환 버전 |
| CDP (Chrome DevTools Protocol) | 브라우저 디버깅 프로토콜 | OpenClaw이 이를 통해 브라우저 제어 |
전체 설정 단계
1. Playwright Chromium 설치
npx playwright install chromium
Playwright는 현재 아키텍처에 적합한 Chromium을 자동으로 다운로드합니다.
2. 중국어 글꼴 설치
헤드리스 브라우저 스크린샷에서 중국어 글꼴을 사용하려면 별도로 설치해야 합니다.
sudo apt-get install -y fonts-wqy-microhei fonts-wqy-zenhei
fc-cache -fv
3. 브라우저 시작
Chromium을 CDP 모드로 실행해야 합니다.
4. OpenClaw 설정
~/.openclaw/openclaw.json 파일을 편집하고 browser 섹션을 추가하거나 수정합니다.
5. 설정 확인
openclaw browser status
openclaw browser screenshot
고급 사용법
자동 시작 스크립트
서버 재부팅 후에도 브라우저가 자동으로 시작되도록 systemd 서비스를 추가하는 것이 좋습니다.
브라우저 프로필 유지
로그인 상태를 유지하려면 사용자 데이터 디렉터리를 지정하면 됩니다.
--user-data-dir=/path/to/profile
이렇게 하면 브라우저가 쿠키와 세션을 기억하므로 로그인 한 번이면 충분합니다.
자주 묻는 질문
글꼴이 여전히 깨지는 경우
글꼴이 제대로 로드되었는지 확인합니다.
fc-list :lang=zh
결과가 비어 있다면 Chrome에서 접근할 수 있는 디렉터리에 글꼴을 직접 다운로드해야 할 수 있습니다.
CDP 연결 실패
- 포트가 사용 중인지 확인합니다:
lsof -i:18800 - 브라우저 로그를 확인합니다:
cat /tmp/chrome.log - 브라우저를 다시 시작해 봅니다
스크린샷이 빈 화면인 경우
페이지가 아직 완전히 로드되지 않았을 수 있으므로 대기 시간을 늘립니다.
효과 시연
설정을 완료하면 다음과 같이 사용할 수 있습니다.
- AI로 날씨 확인: 현재 날씨를 바로 스크린샷해 사용자에게 보내기
- 자동 체크인: 매일 정해진 시간에 웹페이지를 열어 체크인 버튼 클릭
- 콘텐츠 모니터링: 특정 웹페이지의 변경 사항을 모니터링해 사용자에게 알림
- 보고서 생성: 관리자 대시보드를 자동으로 열어 스크린샷으로 일일 보고서 생성
요약
이 글에서는 ARM64 서버에서 OpenClaw에 헤드리스 브라우저를 구성하는 전체 과정을 자세히 설명했습니다. Chrome을 직접 설치하는 것보다 과정이 조금 더 복잡하지만, Playwright + CDP 조합을 사용하면 다음과 같은 결과를 최종적으로 얻을 수 있었습니다.
- ✅ ARM64 호환
- ✅ 중국어 글꼴 지원
- ✅ OpenClaw 통합
- ✅ 자동화 기능
서버에서 AI 어시스턴트를 실행해야 한다면 이 방법을 시도해 보세요.