> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clawdia.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Browser

# `clawdia browser`

Manage Clawdia’s browser control server and run browser actions (tabs, snapshots, screenshots, navigation, clicks, typing).

Related:

* Browser tool + API: [Browser tool](/tools/browser)
* Chrome extension relay: [Chrome extension](/tools/chrome-extension)

## Common flags

* `--url <controlUrl>`: override `browser.controlUrl` for this command invocation.
* `--browser-profile <name>`: choose a browser profile (default comes from config).
* `--json`: machine-readable output (where supported).

## Quick start (local)

```bash theme={null}
clawdia browser --browser-profile chrome tabs
clawdia browser --browser-profile clawd start
clawdia browser --browser-profile clawd open https://example.com
clawdia browser --browser-profile clawd snapshot
```

## Profiles

Profiles are named browser routing configs. In practice:

* `clawd`: launches/attaches to a dedicated Clawdia-managed Chrome instance (isolated user data dir).
* `chrome`: controls your existing Chrome tab(s) via the Chrome extension relay.

```bash theme={null}
clawdia browser profiles
clawdia browser create-profile --name work --color "#FF5A36"
clawdia browser delete-profile --name work
```

Use a specific profile:

```bash theme={null}
clawdia browser --browser-profile work tabs
```

## Tabs

```bash theme={null}
clawdia browser tabs
clawdia browser open https://docs.clawdia.cc
clawdia browser focus <targetId>
clawdia browser close <targetId>
```

## Snapshot / screenshot / actions

Snapshot:

```bash theme={null}
clawdia browser snapshot
```

Screenshot:

```bash theme={null}
clawdia browser screenshot
```

Navigate/click/type (ref-based UI automation):

```bash theme={null}
clawdia browser navigate https://example.com
clawdia browser click <ref>
clawdia browser type <ref> "hello"
```

## Chrome extension relay (attach via toolbar button)

This mode lets the agent control an existing Chrome tab that you attach manually (it does not auto-attach).

Install the unpacked extension to a stable path:

```bash theme={null}
clawdia browser extension install
clawdia browser extension path
```

Then Chrome → `chrome://extensions` → enable “Developer mode” → “Load unpacked” → select the printed folder.

Full guide: [Chrome extension](/tools/chrome-extension)

## Remote browser control (`clawdia browser serve`)

If the Gateway runs on a different machine than the browser, run a standalone browser control server on the machine that runs Chrome:

```bash theme={null}
clawdia browser serve --bind 127.0.0.1 --port 18791 --token <token>
```

Then point the Gateway at it using `browser.controlUrl` + `browser.controlToken` (or `CLAWDIA_BROWSER_CONTROL_TOKEN`).

Security + TLS best-practices: [Browser tool](/tools/browser), [Tailscale](/gateway/tailscale), [Security](/gateway/security)