dvcrn Use My Browser
Operate the user's real Chrome browser through Tampermonkey script injection. The agent runs JavaScript directly in the page context — sharing all cookies, sessions, and login state.
Setup
openclaw plugins install openclaw-tmwd --registry https://registry.npmjs.org
Then install the Tampermonkey userscript in Chrome. Green indicator at bottom-right = connected.
Tools
| Tool | Purpose |
|---|---|
tmwd_status |
Check connection, list connected tabs |
tmwd_switch |
Switch to tab matching URL pattern |
tmwd_navigate |
Navigate current tab to URL |
tmwd_newtab |
Open new tab |
tmwd_text |
Get visible text of current page |
tmwd_elements |
List interactive elements (buttons, links, inputs) |
tmwd_scan |
Get simplified HTML |
tmwd_exec |
Execute JavaScript in page context |
Workflow
Read a page
tmwd_status() # Verify connection
tmwd_switch(pattern="github.com") # Switch to target tab
tmwd_text(max_chars=5000) # Get page content
Navigate to URL
tmwd_navigate(url="https://example.com")
tmwd_text()
Click / fill / interact
tmwd_exec(code="document.querySelector('#submit').click()")
tmwd_exec(code="var e=document.querySelector('#email'); e.value='user@example.com'; e.dispatchEvent(new Event('input',{bubbles:true}))")
Extract data
tmwd_exec(code="return document.querySelector('.content').innerText")
tmwd_exec(code="return Array.from(document.querySelectorAll('h2')).map(e=>e.textContent)")
Read table data
tmwd_exec(code="var rows=document.querySelectorAll('table tr'); var d=[]; rows.forEach(function(r){var c=[]; r.querySelectorAll('td,th').forEach(function(e){c.push(e.innerText.trim())}); if(c.length) d.push(c)}); return d")
Click by text match
tmwd_exec(code="var btns=document.querySelectorAll('button'); for(var i=0;i<btns.length;i++){if(btns[i].innerText.includes('Submit')){btns[i].click();break}}")
Fill form with multiple fields
tmwd_exec(code="var f={'#username':'admin','#email':'a@b.com'}; Object.keys(f).forEach(function(s){var e=document.querySelector(s); e.value=f[s]; e.dispatchEvent(new Event('input',{bubbles:true}))})")
JS Patterns Quick Reference
| Action | Code |
|---|---|
| Click button | document.querySelector('button.submit').click() |
| Fill input | var e=document.querySelector('#input'); e.value='x'; e.dispatchEvent(new Event('input',{bubbles:true})) |
| Select dropdown | var s=document.querySelector('select'); s.value='opt1'; s.dispatchEvent(new Event('change',{bubbles:true})) |
| Check checkbox | var c=document.querySelector('[type=checkbox]'); c.checked=true; c.dispatchEvent(new Event('change',{bubbles:true})) |
| Scroll to bottom | window.scrollTo(0, document.body.scrollHeight) |
| Scroll to element | document.querySelector('#target').scrollIntoView() |
| Wait for element | return !!document.querySelector('.loaded') |
| Get current URL | return location.href |
| Go back | history.back() |
CSP Fallback
Some sites (X/Twitter, banking sites) block eval() via Content Security Policy. When tmwd_exec returns csp_blocked: true, fall back to the built-in browser tool:
1. browser(action="open", profile="openclaw", url="<same-url>")
2. browser(action="snapshot", targetId=<targetId>)
Built-in browser uses CDP which bypasses CSP, but runs in a separate instance (no user login state — login once, profile is persisted).
Rule: always try tmwd first, fall back only on failure.
Troubleshooting
| Problem | Fix |
|---|---|
| "No connected tabs" | Check green indicator in Chrome bottom-right |
| Red indicator | Refresh the page, userscript auto-reconnects |
el.click() no effect |
Try el.dispatchEvent(new MouseEvent('click',{bubbles:true})) |
| CSP blocks eval | Use tmwd_text (no eval needed) or fall back to built-in browser |
Notes
- All JS runs in page context — shares cookies, localStorage, login state
el.click()is DOM-level, does not move the mouse cursor- Cross-origin iframes cannot be accessed (same-origin policy)
- If page refreshes, the userscript auto-reconnects with the same sessionId
- Use
returnin JS to send values back; withoutreturnthere is no output - For React/Vue apps, always use
dispatchEventafter setting values — direct.value=alone won't trigger framework reactivity