메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
수동 로그인(권장)

사이트에 로그인이 필요한 경우 호스트 브라우저 프로필(openclaw 브라우저)에서 수동으로 로그인하세요. 모델에 자격 증명을 제공하지 마세요. 자동 로그인은 봇 방어를 트리거하는 경우가 많으며 계정이 잠길 수 있습니다. 기본 브라우저 문서로 돌아가기: 브라우저.

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

OpenClaw는 전용 Chrome 프로필(openclaw라는 이름, 주황색 UI)을 제어합니다. 이는 일상적으로 사용하는 브라우저 프로필과 별개입니다. 에이전트 브라우저 도구 호출의 경우:
  • 기본 선택: 에이전트는 격리된 openclaw 브라우저를 사용해야 합니다.
  • 기존 로그인 세션이 중요하고 사용자가 컴퓨터 앞에서 연결 프롬프트를 클릭/승인할 수 있을 때만 profile="user"를 사용하세요.
  • 사용자 브라우저 프로필이 여러 개 있으면 추측하지 말고 프로필을 명시적으로 지정하세요.
접근하는 쉬운 방법 두 가지:
  1. 에이전트에게 브라우저를 열도록 요청한 다음 직접 로그인하세요.
  2. CLI로 열기:
openclaw browser start
openclaw browser open https://x.com
프로필이 여러 개 있으면 --browser-profile <name>을 전달하세요(기본값은 openclaw).

​
X/Twitter: 권장 흐름

  • 읽기/검색/스레드: 호스트 브라우저를 사용하세요(수동 로그인).
  • 업데이트 게시: 호스트 브라우저를 사용하세요(수동 로그인).

​
샌드박싱 + 호스트 브라우저 접근

샌드박스 브라우저 세션은 봇 감지를 트리거할 가능성이 더 높습니다. X/Twitter(및 기타 엄격한 사이트)의 경우 호스트 브라우저를 선호하세요. 에이전트가 샌드박스된 경우 브라우저 도구는 기본적으로 샌드박스를 사용합니다. 호스트 제어를 허용하려면: 
{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main",
        browser: {
          allowHostControl: true,
        },
      },
    },
  },
}
그런 다음 호스트 브라우저를 직접 여세요(CLI 호출은 항상 호스트 브라우저를 대상으로 실행됩니다). 
openclaw browser open https://x.com --browser-profile openclaw
sandbox.browser.allowHostControl: true가 설정되면 에이전트의 browser 도구 호출은 호스트를 대상으로 지정할 수 있습니다. 또는 업데이트를 게시하는 에이전트의 샌드박싱을 비활성화하세요.

​
관련 항목