2026 OpenClaw 브라우저 확장 실전:
일일 Mac 대여로 Safari/Chrome 웹 자동화

01. OpenClaw v2026.2.22 지속형 브라우저 확장: 기존 방식과의 차이

OpenClaw v2026.2.22부터 브라우저 제어 방식이 정리되었습니다. 기존에는 OpenClaw가 자체 Chromium 인스턴스를 띄우는 Managed 모드나 CDP(Chrome DevTools Protocol)로 기존 브라우저에 접속하는 방식이 주였습니다. 2026년 추가된 Extension Relay 모드는 경량 Chrome MV3 확장으로 사용 중인 Chrome 탭에 붙어 CDP 메시지를 릴레이하는 방식입니다. 로그인 세션·쿠키가 유지된 브라우저를 그대로 사용할 수 있어 E2E 테스트나 인증이 필요한 웹 시나리오에 적합합니다.

실무에서 가장 큰 장점은 Safari 17 환경을 macOS에서만 안정적으로 운용할 수 있다는 점입니다. Safari는 Chromium 계열이 아니라 별도 엔진이며, 원격 Mac에서 VNC 또는 SSH로 접속한 뒤 Safari와 Chrome을 동시에 자동화 파이프라인에 넣을 수 있습니다. 본문에서는 일일 Mac 대여를 전제로, Mac을 소유하지 않은 팀이 10분 수준으로 환경을 맞추는 플로우를 설명합니다.

02. 웹 자동화 테스트에 실제 macOS가 필요한 이유

VM이나 컨테이너에서 Safari·WebKit을 돌리면 다음과 같은 한계가 있습니다.

• WebKit 엔진 차이: Linux 컨테이너의 Playwright WebKit은 macOS Safari와 렌더링·JS 엔진 동작이 미세하게 다릅니다. iOS Safari 호환 검증에는 macOS Safari 17이 사실상 필수입니다.
• 확장 API 제한: OpenClaw Chrome 확장은 chrome.debugger API를 사용합니다. 컨테이너 환경에서는 GUI가 없어 확장을 붙일 브라우저 창이 없고, CDP 릴레이 포트 구성도 복잡해집니다.
• Metal·GPU 의존: OpenClaw의 화면 인식·비전 모델은 Metal을 활용합니다. 물리 Mac에서는 가속이 안정적이지만 VM에서는 그래픽 패스스루 이슈로 실패하는 경우가 있습니다.

따라서 Safari 17 + Chrome 양쪽 E2E 자동화를 안정적으로 돌리려면 물리 macOS 환경이 필요합니다. Mac 없는 팀은 일일 Mac 대여로 필요한 기간만 베어메탈 노드를 켜는 방식이 비용·운영 모두 효율적입니다.

방식별 비교 매트릭스

03. 10분 안에 구성: 일일 Mac 개통 → OpenClaw → 확장 활성화

아래 5단계는 MacDate 일일 Mac 노드를 기준으로 한 최소 구성입니다. 사전 설치된 OpenClaw 환경을 제공하는 노드를 사용하면 2~4단계가 대폭 단축됩니다.

1단계: 일일 Mac 노드 개통

MacDate 대시보드에서 M4 베이스 이상 노드를 일 단위로 개통합니다. 홍콩·싱가포르 노드 기준 약 $3.90~$5.50/일 수준이며, 90초 내 프로비저닝됩니다. 개통 후 SSH 키 또는 비밀번호로 접속 정보를 확인합니다.

2단계: OpenClaw 설치 (사전 설치 노드가 아닌 경우)

# Homebrew로 OpenClaw 설치 (macOS)
brew install openclaw

# 또는 npm
npm install -g @openclaw/cli

3단계: 브라우저 확장 설치

openclaw browser extension install
openclaw browser extension path

출력된 경로를 복사해 Chrome → chrome://extensions → "압축 해제된 확장 프로그램 로드"에서 해당 디렉터리를 선택합니다. 개발자 모드를 켜고 확장을 고정합니다.

4단계: Gateway 토큰 설정

확장 옵션 페이지에서 Gateway token을 입력합니다. 이 값은 gateway.auth.token 또는 OPENCLAW_GATEWAY_TOKEN과 일치해야 합니다. 기본 릴레이 포트는 18792입니다 (커스텀 Gateway 포트 사용 시 포트+3).

5단계: 탭 부착 및 검증

제어할 Chrome 탭을 열고 확장 아이콘을 클릭합니다. 뱃지가 "ON"으로 표시되면 부착 완료입니다. CLI에서 openclaw browser --browser-profile chrome tabs로 연결 상태를 확인합니다.

04. Safari 17 + Chrome 양쪽 호환 테스트 자동화 설정

Safari는 Extension Relay를 지원하지 않으므로 OpenClaw Managed 모드 또는 CDP로 별도 제어합니다. 실전에서는 Chrome 확장으로 로그인·쿠키가 필요한 시나리오를 처리하고, Safari는 별도 프로파일로 E2E 시나리오를 돌리는 구성이 일반적입니다.

Chrome 확장 프로파일 (이미 부착된 탭 제어)

# 기본 chrome 프로파일 사용
openclaw browser --browser-profile chrome tabs

# 커스텀 프로파일 생성
openclaw browser create-profile \
  --name my-chrome \
  --driver extension \
  --cdp-url http://127.0.0.1:18792

Safari 17 CDP 연결

Safari 17은 개발자 메뉴에서 "웹 검사기 활성화" 후 CDP를 열 수 있습니다. OpenClaw에서 CDP URL로 Safari 인스턴스에 연결하는 프로파일을 정의합니다. 원격 Mac에서는 VNC로 Safari를 띄워 둔 뒤 CDP 포트를 포워딩하는 방식으로 구성할 수 있습니다.

이중 브라우저 테스트 플로우 예시

1. Chrome 확장 프로파일로 로그인·세션 유지된 페이지에서 주요 플로우 자동화
2. Safari CDP 프로파일로 동일 시나리오 재실행, Safari 전용 렌더링 이슈 수집
3. 스크린샷·히어로 요소 비교로 두 브라우저 결과 차이 파악

05. 회피 포인트: SIP, 확장 권한, VNC 입력법

• SIP(System Integrity Protection) 제한: macOS의 SIP는 일부 디버거·확장 동작을 제한합니다. OpenClaw 확장은 chrome.debugger를 사용하므로 Safari Web Inspector와 충돌할 수 있습니다. Chrome 전용 세션과 Safari 전용 세션을 분리해 동시에 붙이지 않도록 합니다.
• 확장 권한 충돌: 다른 CDP 기반 도구(Playwright, Puppeteer)가 같은 탭에 붙어 있으면 충돌합니다. OpenClaw 확장을 쓸 때는 해당 탭에서 다른 디버거 접속을 끕니다.
• 원격 VNC 입력법 전환: VNC 터미널로 원격 Mac에 접속해 작업할 때 입력 소스가 한/영 등으로 바뀌면 스크립트 입력이 깨질 수 있습니다. 테스트 전에 입력 소스를 영어(미국)로 고정하고, 필요 시 defaults write ...로 기본 입력법을 설정해 두는 것을 권장합니다.