browser-use
Cloud-based browser automation with managed sessions and autonomous task execution.
Installation
npx clawhub@latest install browser-useView the full skill documentation and source below.
Documentation
Browser Use
Browser Use provides cloud browsers and autonomous browser automation via API.
Docs:
- Open source library:
- Cloud API:
Setup
API Key is read from clawdbot config at skills.entries.browser-use.apiKey.
If not configured, tell the user:
To use Browser Use, you need an API key. Get one at (new signups get $10 free credit). Then configure it:
> clawdbot config set skills.entries.browser-use.apiKey "bu_your_key_here" >
Base URL:
All requests need header: X-Browser-Use-API-Key:
---
## 1. Browser Sessions (Primary)
Spin up cloud browsers for Clawdbot to control directly. Use profiles to persist logins and cookies.
### Create browser session
__CODE_BLOCK_1__
**Response:**
__CODE_BLOCK_2__
### Connect Clawdbot to the browser
__CODE_BLOCK_3__
Now use the browser tool with profile=browseruse to control it.
### List/stop browser sessions
__CODE_BLOCK_4__
**Pricing:** $0.06/hour (Pay As You Go) or $0.03/hour (Business). Max 4 hours per session. Billed per minute, refunded for unused time.
---
## 2. Profiles
Profiles persist cookies and login state across browser sessions. Create one, log into your accounts in the browser, and reuse it.
__CODE_BLOCK_5__
**Tip:** You can also sync cookies from your local Chrome using the Browser Use Chrome extension.
---
## 3. Tasks (Subagent)
Run autonomous browser tasks - like a subagent that handles browser interactions for you. Give it a prompt and it completes the task.
**Always use browser-use-llm** - optimized for browser tasks, 3-5x faster than other models.
__CODE_BLOCK_6__
### Poll for completion
__CODE_BLOCK_7__
**Response:**
__CODE_BLOCK_8__
Status values: pending, running, finished, failed, stopped
### Task options
| Option | Description |
|--------|-------------|
| task | Your prompt (required) |
| llm | Always use browser-use-llm |
| startUrl | Starting page |
| maxSteps | Max actions (default 100) |
| sessionId | Reuse existing session |
| profileId | Use a profile for auth |
| flashMode | Even faster execution |
| vision` | Visual understanding |
Full API Reference
See references/api.md for all endpoints including Sessions, Files, Skills, and Skills Marketplace.