브라우저 로그인

수동 로그인(권장)

사이트에서 로그인이 필요한 경우 호스트 브라우저의 openclaw 프로필에서 직접 로그인하세요. 모델에 자격 증명을 제공하지 마세요. 자동 로그인은 봇 차단 기능을 작동시키는 경우가 많으며 계정이 잠길 수 있습니다.

X/Twitter 및 기타 봇에 민감한 사이트에서 읽기(검색/스레드)와 게시를 모두 수행할 때는 호스트 브라우저(수동 로그인)를 사용하세요. 샌드박스 브라우저 세션은 봇 탐지를 작동시킬 가능성이 더 높습니다.

기본 브라우저 문서로 돌아가기: 브라우저.

어떤 Chrome 프로필이 사용되나요?

OpenClaw는 일상적으로 사용하는 브라우저 프로필과 별개인 openclaw라는 전용 Chrome 프로필(주황색 계열 UI)을 제어합니다.

에이전트의 브라우저 도구 호출 시:

• 기본 선택: 에이전트는 격리된 openclaw 브라우저를 사용합니다.
• 기존 로그인 세션이 중요하고 연결 프롬프트를 직접 클릭하거나 승인할 수 있도록 컴퓨터 앞에 있을 때만 profile="user"를 사용하세요.
• 사용자 브라우저 프로필이 여러 개라면 추측하지 말고 프로필을 명시적으로 지정하세요.

openclaw 프로필에 접근하는 두 가지 방법:

1. 에이전트에게 브라우저를 열도록 요청한 다음 직접 로그인합니다.
2. CLI를 통해 엽니다.

openclaw browser startopenclaw browser open https://x.com

기본값이 아닌 프로필을 사용하려면 하위 명령 앞에 --browser-profile <name>을 입력하세요(기본값은 openclaw).

openclaw browser --browser-profile <name> open https://x.com

샌드박싱: 호스트 브라우저 접근 허용

에이전트가 샌드박스에서 실행되는 경우 browser 도구 호출은 기본적으로 호스트가 아닌 샌드박스 브라우저를 사용합니다. 에이전트가 대신 호스트 브라우저를 대상으로 지정할 수 있게 하려면 다음과 같이 설정하세요.

{  agents: {    defaults: {      sandbox: {        mode: "non-main",        browser: {          allowHostControl: true,        },      },    },  },}

CLI 호출은 항상 샌드박스가 아닌 호스트 브라우저를 대상으로 하므로, 이 설정과 관계없이 호스트 브라우저를 직접 열 수 있습니다.

openclaw browser --browser-profile openclaw open https://x.com

sandbox.browser.allowHostControl: true를 설정하면 에이전트의 browser 도구 호출도 호스트를 대상으로 지정할 수 있습니다. 또는 업데이트를 게시하는 에이전트의 샌드박싱을 비활성화하세요.

관련 문서

• 브라우저
• Linux 브라우저 문제 해결
• WSL2 브라우저 문제 해결