Browser Automation

YouClaw's browser feature lets the assistant work inside a real browser session. It can open pages, navigate tabs, click buttons, type into forms, capture page snapshots, and reuse your saved login state across chats.

How It Works

The browser feature is built around persistent browser profiles:

  • Managed profile — YouClaw launches a local Chrome or Chromium instance for you
  • Remote CDP profile — YouClaw connects to an existing browser over the Chrome DevTools Protocol
  • Persistent session — Cookies, local storage, and other browser state are stored in the profile directory and reused later

Typical Workflow

  1. Create a browser profile in Settings.
  2. Start the profile and sign in to websites manually.
  3. Bind the profile to an Agent, or select it directly in chat.
  4. Let YouClaw reuse that browser session for later tasks.

This makes browser automation useful for authenticated sites such as dashboards, admin panels, seller consoles, or internal tools.

What YouClaw Can Do

With the built-in browser tools, YouClaw can:

  • Check browser status and list open tabs
  • Open a new tab or navigate to a URL
  • Capture a lightweight text snapshot of the current page
  • Take a full-page screenshot
  • Click elements by CSS selector
  • Type into inputs and textareas
  • Send keyboard shortcuts such as Enter
  • Close the current tab

For advanced browser operations, YouClaw can also fall back to the legacy agent-browser skill for capabilities such as explicit waits, interactive element refs, select or check actions, PDF export, visual diff, and session state import or export.

Browser Profiles in Agents and Chats

Browser profiles can be applied at two levels:

  • Agent default profile — Reuse the same browser session whenever that Agent runs
  • Chat-level selection — Choose a specific profile for one conversation, or switch the chat to No browser

This lets you keep separate browser sessions for work accounts, personal accounts, staging environments, or different clients.

Manual Login and Safety

Manual login is the recommended flow.

  • Do not share passwords, 2FA codes, recovery codes, or session secrets with the assistant
  • If a site shows CAPTCHA, suspicious-login checks, device verification, or other anti-bot protection, take over manually
  • For high-impact actions such as payments, purchases, account-security changes, publishing, or deleting data, YouClaw should prepare the page and let you complete the final confirmation yourself

When to Use Browser Mode

Browser mode is a good fit when you need to:

  • Work with sites that require login
  • Reuse a real browser session across multiple tasks
  • Capture screenshots or page text from the current browser tab
  • Automate repetitive web steps inside a known UI

If you only need fresh public information from the open web, web search is usually a better choice than browser automation.

Privacy

Browser data stays local to your device.

  • Managed profiles store browser data in a local profile directory
  • Login state is reused only through the profile you choose
  • Deleting a browser profile also removes its saved browser data