> ## Documentation Index
> Fetch the complete documentation index at: https://oc-guide.openclaw-korea.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Chrome 릴레이

> 기존 Chrome 브라우저를 AI로 제어하기

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

## 왜 Chrome 릴레이인가?

<CardGroup cols={2}>
  <Card title="🔑 기존 로그인 활용" icon="key">
    Gmail, GitHub, Notion 등 이미 로그인된 사이트를 그대로 사용
  </Card>

  <Card title="🧩 확장 프로그램" icon="puzzle-piece">
    Chrome 확장 프로그램으로 간편하게 연결
  </Card>
</CardGroup>

## 설정

<Steps>
  <Step title="Chrome 확장 프로그램 설치">
    OpenClaw Browser Relay 확장 프로그램을 Chrome에 설치합니다.
  </Step>

  <Step title="탭 연결">
    제어할 탭에서 **OpenClaw Browser Relay 툴바 아이콘**을 클릭합니다.
    뱃지가 **ON**으로 바뀌면 연결 완료입니다.
  </Step>

  <Step title="AI에서 사용">
    ```
    browser.snapshot(profile="chrome")
    ```

    연결된 탭의 DOM 구조를 AI가 읽을 수 있습니다.
  </Step>
</Steps>

## 사용법

### 스냅샷

```
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")
```

<Info>
  Chrome 릴레이를 사용할 때는 항상 `profile="chrome"`을 지정합니다.
  `profile="openclaw"`는 격리된 별도 브라우저입니다.
</Info>

## 실전 활용

### 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 (격리) |
| ------- | ------------ | ------------- |
| 로그인 세션  | 기존 유지        | 없음            |
| 확장 프로그램 | 필요           | 불필요           |
| 보안      | 기존 세션 노출     | 격리됨           |
| 설정      | 탭별 수동 연결     | 자동            |
| 용도      | 인증 필요 사이트    | 공개 사이트        |

<Warning>
  Chrome 릴레이는 기존 로그인 세션을 AI에 노출합니다.
  민감한 금융 사이트 등에서는 주의해서 사용하세요.
  릴레이를 사용하지 않을 때는 반드시 뱃지를 OFF로 두세요.
</Warning>

## 문제 해결

| 증상                 | 해결                         |
| ------------------ | -------------------------- |
| "no tab connected" | 릴레이 확장 프로그램에서 탭 연결 (뱃지 ON) |
| 스냅샷 비어있음           | 페이지 로딩 완료 후 재시도            |
| 액션 실패              | ref가 변경되었을 수 있음, 스냅샷 재실행   |

<Tip>
  안정적인 자동화를 위해 `targetId`를 스냅샷 응답에서 가져와 후속 액션에 전달하세요.
  탭 전환으로 인한 오류를 방지합니다.
</Tip>