​

Chrome 확장 프로그램 (브라우저 릴레이)

​

개념

• 브라우저 제어 서비스(게이트웨이나 노드): 에이전트/도구가 호출하는 API (게이트웨이를 통해)
• 로컬 릴레이 서버(루프백 CDP): 제어 서버와 확장 프로그램 간의 브리지 역할을 합니다 (기본값 http://127.0.0.1:18792).
• Chrome MV3 확장 프로그램: chrome.debugger를 사용하여 활성 탭에 부착하고 CDP 메시지를 릴레이로 전송합니다.

​

설치 / 로드 (압축 해제 형태)

1. 확장 프로그램을 안정적인 로컬 경로에 설치합니다:

openclaw browser extension install

2. 설치된 확장 프로그램 디렉토리 경로를 출력합니다:

openclaw browser extension path

3. Chrome → chrome://extensions

• “개발자 모드” 활성화
• “압축 해제 로드” → 위에서 출력된 디렉토리 선택

4. 확장 프로그램을 고정합니다.

​

업데이트 (빌드 단계 없음)

• openclaw browser extension install을 다시 실행하여 OpenClaw 상태 디렉토리 아래 설치된 파일을 새로 고칩니다.
• Chrome → chrome://extensions → 확장 프로그램에서 “다시 로드”를 클릭합니다.

​

사용법 (게이트웨이 토큰 한 번 설정)

• Port (기본값 18792)
• Gateway token (gateway.auth.token / OPENCLAW_GATEWAY_TOKEN과 일치해야 함)

• CLI: openclaw browser --browser-profile chrome tabs
• 에이전트 도구: browser with profile="chrome"

openclaw browser create-profile \
  --name my-chrome \
  --driver extension \
  --cdp-url http://127.0.0.1:18792 \
  --color "#00AA00"

​

부착 / 분리 (툴바 버튼)

• OpenClaw가 제어할 탭을 엽니다.
• 확장 프로그램 아이콘을 클릭합니다.
  • 부착 시 배지에 ON이 표시됩니다.
• 다시 클릭하여 분리합니다.

​

어떤 탭을 제어하나요?

• 자동으로 “당신이 보고 있는 탭”을 제어하지 않습니다.
• 툴바 버튼을 클릭하여 명시적으로 부착한 탭만 제어합니다.
• 전환하려면: 다른 탭을 열고 그곳에서 확장 아이콘을 클릭하세요.

​

배지 + 일반 오류

• ON: 부착됨; OpenClaw가 해당 탭을 제어할 수 있습니다.
• …: 로컬 릴레이에 연결 중.
• !: 릴레이에 연결할 수 없거나 인증 실패 (가장 흔함: 릴레이 서버가 실행 중이지 않거나, 게이트웨이 토큰이 누락되었거나 잘못됨).

• 게이트웨이가 로컬에서 실행 중인지 확인하세요 (기본 설정), 또는 게이트웨이가 다른 곳에서 실행 중이라면 이 기기에 노드 호스트를 실행하세요.
• 확장 프로그램 옵션 페이지를 엽니다; 릴레이 도달 가능성과 게이트웨이 토큰 인증을 검증합니다.

​

원격 게이트웨이 (노드 호스트 사용)

​

로컬 게이트웨이 (Chrome과 동일 기기) — 추가 단계 없음이 보통

​

원격 게이트웨이 (게이트웨이가 다른 곳에서 실행 중) — 노드 호스트 실행

​

샌드박스 격리 (도구 컨테이너)

• 기본적으로, 샌드박스 격리 세션은 종종 샌드박스 브라우저(target="sandbox")를 목표로 하며, 호스트 Chrome이 아닙니다.
• Chrome 확장 프로그램 릴레이 인수는 호스트 브라우저 제어 서버를 제어해야 합니다.

• 가장 쉬운 방법: 비-샌드박스 격리 세션/에이전트에서 확장 프로그램을 사용하세요.
• 아니면 샌드박스 격리 세션에 대해 호스트 브라우저 제어를 허용하세요:

{
  agents: {
    defaults: {
      sandbox: {
        browser: {
          allowHostControl: true,
        },
      },
    },
  },
}

​

원격 액세스 팁

• 게이트웨이와 노드 호스트를 동일한 테일넷에 두세요; 릴레이 포트를 LAN이나 공용 인터넷에 노출하지 마세요.
• 노드를 의도적으로 페어링하세요; 원격 제어를 원치 않는 경우 브라우저 프록시 라우팅을 비활성화하세요 (gateway.nodes.browser.mode="off").

​

’확장 경로’의 작동 방식

​

보안 영향 (읽어보세요)

• 확장은 Chrome의 디버거 API(chrome.debugger)를 사용합니다. 부착되면, 모델은 다음을 수행할 수 있습니다:
  • 해당 탭에서 클릭/타이핑/탐색
  • 페이지 콘텐츠 읽기
  • 탭의 로그인된 세션이 액세스할 수 있는 것에 액세스
• 이것은 별도로 격리되지 않습니다 openclaw-관리 전용 프로필처럼.
  • 당신의 일상 사용 프로필/탭에 부착하면, 해당 계정 상태에 대한 액세스를 부여하는 것입니다.

• 확장 릴레이 사용을 위해 개인 브라우징과 별개의 전용 Chrome 프로필을 선호하세요.
• 게이트웨이 및 모든 노드 호스트를 테일넷 전용으로 유지시키세요; 게이트웨이 인증 + 노드 페어링을 신뢰하세요.
• 릴레이 포트를 LAN (0.0.0.0)에 노출시키지 말고, 퍼널 (공용)을 피하세요.
• 릴레이는 비-확장 기원을 차단하고 /cdp 및 /extension 모두에 게이트웨이 토큰 인증을 요구합니다.

• 브라우저 도구 개요: Browser
• 보안 감사: Security
• Tailscale 설정: Tailscale