浏览器使用（Browser Use）

浏览器使用（Browser Use）通过 API 提供云浏览器及自主浏览器自动化能力。

文档：

• 开源库：https://docs.browser-use.com
• 云 API：https://docs.cloud.browser-use.com

配置

API 密钥（API Key） 从 clawdbot 配置中读取，路径为 skills.entries.browser-use.apiKey。

若未配置，请向用户提示：

如需使用 Browser Use，您需要一个 API 密钥。请前往 https://cloud.browser-use.com 获取（新注册用户可获赠 $10 免费额度）。然后执行如下配置：

clawdbot config set skills.entries.browser-use.apiKey "bu_your_key_here"

基础 URL：https://api.browser-use.com/api/v2

所有请求均需携带请求头：X-Browser-Use-API-Key:

1. 浏览器会话（主要功能）

启动云浏览器，供 Clawdbot 直接控制。可使用 Profile 持久化登录状态与 Cookie。

创建浏览器会话

# 使用 Profile（推荐 — 可保持登录状态）
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": "", "timeout": 60}'

# 不使用 Profile（全新浏览器实例）
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://.cdp2.browser-use.com",
  "liveUrl": "https://...",
  "status": "active"
}

将 Clawdbot 连接到该浏览器

gateway config.patch '{"browser":{"profiles":{"browseruse":{"cdpUrl":""}}}}'

此后即可使用 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/" -H "X-Browser-Use-API-Key: $API_KEY"

# 停止会话（未使用时长将自动退款）
curl -X PATCH "https://api.browser-use.com/api/v2/browsers/" 
  -H "X-Browser-Use-API-Key: $API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"status": "stopped"}'

计费说明：按量付费 $0.06/小时，企业版 $0.03/小时。单次会话最长 4 小时，按分钟计费，未使用时长自动退款。

2. Profile

Profile 可跨浏览器会话持久化 Cookie 与登录状态。创建一个 Profile，在其中完成账号登录后，即可重复使用。

# 列出所有 Profile
curl "https://api.browser-use.com/api/v2/profiles" -H "X-Browser-Use-API-Key: $API_KEY"

# 创建 Profile
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"}'

# 删除 Profile
curl -X DELETE "https://api.browser-use.com/api/v2/profiles/" 
  -H "X-Browser-Use-API-Key: $API_KEY"

提示：您还可通过 Browser Use 官方 Chrome 扩展，将本地 Chrome 的 Cookie 同步至云端 Profile。

3. 任务（Task，子智能体）

运行自主浏览器任务 —— 类似一个专司浏览器交互的子智能体。只需提供自然语言指令，系统将自动完成对应操作。

务必使用 browser-use-llm —— 专为浏览器任务优化，执行速度比其他模型快 3–5 倍。

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": "访问 amazon.com 并查找 MacBook Air M3 的价格",
    "llm": "browser-use-llm"
  }'

轮询任务完成状态

curl "https://api.browser-use.com/api/v2/tasks/" -H "X-Browser-Use-API-Key: $API_KEY"

响应示例：

{
  "status": "finished",
  "output": "MacBook Air M3 售价为 $1,099",
  "isSuccess": true,
  "cost": "0.02"
}

可能的状态值：pending、running、finished、failed、stopped

任务可选参数

完整 API 参考文档

所有 API 端点（含会话、文件、技能、技能市场等）详见 references/api.md。