clawme

# ClawMe — Execute Actions in User's Real Browser

Send instructions to the user's Chrome browser via the ClawMe extension. The user sees each instruction in a side panel and clicks "Execute" to confirm. Unlike headless browsers, ClawMe runs in the user's real browser with their actual login sessions.

**Setup**: User installs ClawMe Chrome extension, configures Backend URL and Token.

## How to Send Instructions

Use the `clawme_send` tool if available. Otherwise, make an HTTP POST:

```
POST ${CLAWME_BASE_URL:-https://api.clawme.net}/v1/instructions
Headers: Content-Type: application/json, X-ClawMe-Token: ${CLAWME_CLIENT_TOKEN}
Body: {"target":"browser","instruction":{"type":"<type>","payload":{...}}}
```

## Instruction Types

### compose_tweet
When user says "tweet about...", "post on X..."
```json
{"type":"compose_tweet","payload":{"text":"tweet content"}}
```

### compose_email
When user says "write email to...", "send email..."
```json
{"type":"compose_email","payload":{"to":"email@example.com","subject":"Subject","body":"Body text","use_gmail":true}}
```

### fill_form
When user says "fill the form...", "enter my info..."
```json
{"type":"fill_form","payload":{"url":"https://example.com/form","fields":{"#name":"John","input[name=email]":"john@example.com","select[name=country]":"US"}}}
```
Supports: inputs, textareas, selects, checkboxes, radio, contenteditable (Xiaohongshu, Medium). Use CSS selectors as field keys. Omit `url` for current page.

### click
When user says "click the button...", "submit the form..."
```json
{"type":"click","payload":{"selector":"button[type=submit]","url":"https://example.com/form"}}
```

### extract
When user says "get the text from...", "scrape..."
```json
{"type":"extract","payload":{"selector":".results","url":"https://example.com/search"}}
```
Result (extracted text) is reported back to the agent.

### open_url
```json
{"type":"open_url","payload":{"url":"https://example.com","in_new_tab":true}}
```

### remind
```json
{"t...