Skip to main content
Chrome 릴레이는 실제 Chrome 브라우저를 AI가 제어하는 기능입니다. 기존 로그인 세션을 활용하여 인증이 필요한 사이트도 접근할 수 있습니다.

​
왜 Chrome 릴레이인가?

🔑 기존 로그인 활용

Gmail, GitHub, Notion 등 이미 로그인된 사이트를 그대로 사용

🧩 확장 프로그램

Chrome 확장 프로그램으로 간편하게 연결

​
설정

1

Chrome 확장 프로그램 설치

OpenClaw Browser Relay 확장 프로그램을 Chrome에 설치합니다.
2

탭 연결

제어할 탭에서 OpenClaw Browser Relay 툴바 아이콘을 클릭합니다. 뱃지가 ON으로 바뀌면 연결 완료입니다.
3

AI에서 사용

browser.snapshot(profile="chrome")
연결된 탭의 DOM 구조를 AI가 읽을 수 있습니다.

​
사용법

​
스냅샷

browser.snapshot(profile="chrome")
현재 활성 탭의 접근성 트리를 가져옵니다.

​
액션

# 클릭
browser.act(
  request={kind: "click", ref: "e15"},
  profile="chrome"
)

# 텍스트 입력
browser.act(
  request={kind: "type", ref: "e8", text: "검색어"},
  profile="chrome"
)

# 페이지 이동
browser.navigate(
  url="https://mail.google.com",
  profile="chrome"
)

​
스크린샷

browser.screenshot(profile="chrome")
Chrome 릴레이를 사용할 때는 항상 profile="chrome"을 지정합니다. profile="openclaw"는 격리된 별도 브라우저입니다.

​
실전 활용

​
Gmail 확인

사용자: "Gmail에서 안 읽은 메일 확인해줘"
→ AI:
  1. browser.navigate(url="https://mail.google.com", profile="chrome")
  2. browser.snapshot(profile="chrome")
  3. 안 읽은 메일 목록 추출
  4. 요약해서 전달

​
GitHub PR 리뷰

사용자: "이 PR 리뷰해줘" (URL 공유)
→ AI:
  1. browser.navigate(url="https://github.com/.../pull/123", profile="chrome")
  2. browser.snapshot(profile="chrome")
  3. 변경 사항 분석 및 코멘트 제안

​
Notion 페이지 읽기

사용자: "Notion 회의록 가져와"
→ AI:
  1. Chrome에서 해당 Notion 페이지 열기
  2. 툴바에서 릴레이 ON
  3. browser.snapshot(profile="chrome")
  4. 내용 추출

​
openclaw 프로필과의 비교

기능chrome (릴레이)openclaw (격리)
로그인 세션기존 유지없음
확장 프로그램필요불필요
보안기존 세션 노출격리됨
설정탭별 수동 연결자동
용도인증 필요 사이트공개 사이트
Chrome 릴레이는 기존 로그인 세션을 AI에 노출합니다. 민감한 금융 사이트 등에서는 주의해서 사용하세요. 릴레이를 사용하지 않을 때는 반드시 뱃지를 OFF로 두세요.

​
문제 해결

증상해결
”no tab connected”릴레이 확장 프로그램에서 탭 연결 (뱃지 ON)
스냅샷 비어있음페이지 로딩 완료 후 재시도
액션 실패ref가 변경되었을 수 있음, 스냅샷 재실행
안정적인 자동화를 위해 targetId를 스냅샷 응답에서 가져와 후속 액션에 전달하세요. 탭 전환으로 인한 오류를 방지합니다.