Browser login
기준일: 2026-07-26
난이도: 중급
공식 기준: Browser login
개요
이 페이지는 OpenClaw Browser login 도구(파라미터, 권한, 설정, CLI)를 공식 문서 기준으로 정리합니다.
공식 요약: Manual logins for browser automation + X/Twitter posting
도구 가시성은 profile / allow·deny policy / sandbox / channel 권한에 따라 달라집니다. 최신 스키마는 항상 공식 문서를 우선합니다.
공식 문서 기반 상세
아래는 공식 tools/browser-login 문서를 정리한 내용입니다. 코드 블록, 파라미터 이름, 기본값은 원문 그대로입니다.
Manual login (recommended)
When a site requires login, sign in manually in the host browser's openclaw
profile. Do not give the model your credentials: automated logins often
trigger anti-bot defenses and can lock the account.
Use the host browser (manual login) for both reading (search/threads) and posting on X/Twitter and other bot-sensitive sites. Sandboxed browser sessions are more likely to trigger bot detection.
Back to the main browser docs: Browser.
Which Chrome profile is used?
OpenClaw controls a dedicated Chrome profile named openclaw (orange-tinted
UI), separate from your daily browser profile.
For agent browser tool calls:
- Default choice: the agent uses its isolated
openclawbrowser. - Use
profile="user"only when existing logged-in sessions matter and you are at the computer to click/approve any attach prompt. - If you have multiple user-browser profiles, specify the profile explicitly instead of guessing.
Two ways to access the openclaw profile:
- Ask the agent to open the browser, then log in yourself.
- Open it via CLI:
openclaw browser start
openclaw browser open https://x.com
For a non-default profile, put --browser-profile <name> before the
subcommand (default is openclaw):
openclaw browser --browser-profile <name> open https://x.com
Sandboxing: allow host browser access
If the agent is sandboxed, its browser tool calls default to the sandbox
browser, not the host. To let the agent target the host browser instead:
{
agents: {
defaults: {
sandbox: {
mode: "non-main",
browser: {
allowHostControl: true,
},
},
},
},
}
CLI invocations always target the host browser, never the sandbox, so you can open the host browser yourself regardless of this setting:
openclaw browser --browser-profile openclaw open https://x.com
Once sandbox.browser.allowHostControl: true is set, the agent's browser
tool calls can target the host too. Alternatively, disable sandboxing for the
agent that posts updates.
관련 문서
검증 체크리스트
- 해당 tool이 활성 profile/policy에서 허용되는지 확인
- sandbox / elevated / host 실행 경로 정책을 이해했는지 확인
- 채널·에이전트 권한과 충돌하지 않는지 확인
- 공식 CLI/
--help와 문서 옵션이 버전과 맞는지 확인