Browser Use 通过 API 提供云端浏览器与自主浏览器自动化能力，主要用途是让 Clawdbot 创建并控制云浏览器，以及运行自主浏览器任务。
主要能力
-
浏览器会话（主要功能）：为 Clawdbot 启动可直接控制的云浏览器，可使用配置文件持久化登录状态和 Cookie。创建会话时可选传入 profileId 和 timeout，返回 id、cdpUrl、liveUrl、status 等信息。通过 gateway config.patch 将返回的 cdpUrl 配置为 browseruse 配置文件后，即可用 browser 工具以 profile=browseruse 控制该浏览器。还支持列出活动会话、查询会话状态、停止会话（未使用时间会退还）。
-
配置文件（Profiles）：用于跨浏览器会话持久化 Cookie 和登录状态。可创建、列出、删除配置文件。创建后在浏览器中登录账号即可复用。也可通过 Browser Use Chrome 扩展从本地 Chrome 同步 Cookie。
-
任务（子代理）：运行自主浏览器任务，像子代理一样处理浏览器交互。提交提示词后由系统完成任务，需轮询任务状态获取结果。任务选项包括 task（必填提示词）、llm（建议始终使用 browser-use-llm，据称针对浏览器任务优化，比其他模型快 3-5 倍）、startUrl、maxSteps（默认 100）、sessionId、profileId、flashMode、vision。状态值包括 pending、running、finished、failed、stopped。
使用方式
API 密钥从 clawdbot 配置的 skills.entries.browser-use.apiKey 读取。若未配置，需提示用户前往 https://cloud.browser-use.com 获取密钥（新注册用户可获得 10 美元免费额度），然后执行：
clawdbot config set skills.entries.browser-use.apiKey "bu_your_key_here"
基础地址：https://api.browser-use.com/api/v2
所有请求需携带请求头：X-Browser-Use-API-Key: <apiKey>
创建浏览器会话示例（带配置文件）：
curl -X POST "https://api.browser-use.com/api/v2/browsers"
-H "X-Browser-Use-API-Key: $API_KEY"
-H "Content-Type: application/json"
-d '{"profileId": "<profile-uuid>", "timeout": 60}'
不带配置文件（全新浏览器）：
curl -X POST "https://api.browser-use.com/api/v2/browsers"
-H "X-Browser-Use-API-Key: $API_KEY"
-H "Content-Type: application/json"
-d '{"timeout": 60}'
响应示例：
{ "id": "session-uuid", "cdpUrl": "https://<id>.cdp2.browser-use.com", "liveUrl": "https://...", "status": "active" }
将 Clawdbot 连接到该浏览器：
gateway config.patch '{"browser":{"profiles":{"browseruse":{"cdpUrl":"<cdpUrl-from-response>"}}}}'
之后使用 browser 工具并指定 profile=browseruse 即可控制它。
列出/停止浏览器会话：
列出活动会话
curl "https://api.browser-use.com/api/v2/browsers" -H "X-Browser-Use-API-Key: $API_KEY"
获取会话状态
curl "https://api.browser-use.com/api/v2/browsers/<session-id>" -H "X-Browser-Use-API-Key: $API_KEY"
停止会话（未使用时间会退还）
curl -X PATCH "https://api.browser-use.com/api/v2/browsers/<session-id>"
-H "X-Browser-Use-API-Key: $API_KEY"
-H "Content-Type: application/json"
-d '{"status": "stopped"}'
配置文件操作：
列出配置文件
curl "https://api.browser-use.com/api/v2/profiles" -H "X-Browser-Use-API-Key: $API_KEY"
创建配置文件
curl -X POST "https://api.browser-use.com/api/v2/profiles"
-H "X-Browser-Use-API-Key: $API_KEY"
-H "Content-Type: application/json"
-d '{"name": "My Profile"}'
删除配置文件
curl -X DELETE "https://api.browser-use.com/api/v2/profiles/<profile-id>"
-H "X-Browser-Use-API-Key: $API_KEY"
运行自主任务：
curl -X POST "https://api.browser-use.com/api/v2/tasks"
-H "X-Browser-Use-API-Key: $API_KEY"
-H "Content-Type: application/json"
-d '{
"task": "Go to amazon.com and find the price of the MacBook Air M3",
"llm": "browser-use-llm"
}'
轮询任务完成情况：
curl "https://api.browser-use.com/api/v2/tasks/<task-id>" -H "X-Browser-Use-API-Key: $API_KEY"
响应示例：
{ "status": "finished", "output": "The MacBook Air M3 is priced at $1,099", "isSuccess": true, "cost": "0.02" }
适用场景
适合需要让 Clawdbot 直接控制云浏览器、需要持久化登录状态以复用账号、或需要以子代理方式自动完成网页操作任务的场景。
限制与计费
会话计费为每小时 0.06 美元（按量付费）或每小时 0.03 美元（Business），单会话最长 4 小时，按分钟计费，未使用时间会退还。使用前必须配置 API 密钥。完整 API 参考（包括 Sessions、Files、Skills 和 Skills Marketplace 等端点）见 references/api.md。
文档：
开源库：https://docs.browser-use.com
云 API：https://docs.cloud.browser-use.com