Browserbase Persist with captcha

Browserbase 会话s 技能

Manage persistent cloud browser 会话s via Browserbase. This 技能 创建s browser 会话s that preserve authentication (cookies, local storage) across interactions, automatically solve CAPTCHAs, and record 会话s for later review.

First-Time 设置up Step 1 — 获取 your Browserbase 凭证s 签名 up at browserbase.com if you haven't already. Go to 设置tings → API Keys and copy your API key (启动s with bb_live_). Go to 设置tings → Project and copy your Project ID (a UUID). Step 2 — 安装 dependencies cd {baseDir}/scripts && pip 安装 -r requirements.txt playwright 安装 chromium

Or with uv:

cd {baseDir}/scripts && uv pip 安装 -r requirements.txt uv 运行 playwright 安装 chromium

Step 3 — 设置 环境 variables 导出 BROWSERBASE_API_KEY="bb_live_your_key_here" 导出 BROWSERBASE_PROJECT_ID="your-project-uuid-here"

Or 配置 via OpenClaw's 技能s.entries.browserbase-会话s.env in ~/.OpenClaw/OpenClaw.json.

Step 4 — 运行 the 设置up test

This 验证s everything end-to-end (凭证s, SDK, Playwright, API connection, and a live smoke test):

python3 {baseDir}/scripts/browserbase_管理器.py 设置up

You should see "状态": "成功" with all steps passing. If any step fAIls, the error message tells you exactly what to fix.

Defaults

Every 会话 is 创建d with these defaults to support re搜索 工作流s:

Captcha solving: ON — Browserbase automatically solves CAPTCHAs so 记录in flows and 保护ed pages work without manual intervention. Disable with --no-solve-captchas. 会话 recording: ON — Every 会话 is recorded as a video you can 下载 later for review or sharing. Disable with --no-record. Auth persistence — Use 上下文s with --persist to stay 记录ged in across 会话s. AvAIlable Commands

All commands are 运行 via the 管理器 script:

python3 {baseDir}/scripts/browserbase_管理器.py [options]

设置up & 验证

运行 the full 设置up test:

python3 {baseDir}/scripts/browserbase_管理器.py 设置up

上下文 Management (for authentication persistence)

创建 a named 上下文 to store 记录in 状态:

python3 {baseDir}/scripts/browserbase_管理器.py 创建-上下文 --name github

列出 all saved 上下文s:

python3 {baseDir}/scripts/browserbase_管理器.py 列出-上下文s

删除 a 上下文 (by name or ID):

python3 {baseDir}/scripts/browserbase_管理器.py 删除-上下文 --上下文-id github

会话 Lifecycle

创建 a new 会话 (captcha solving and recording enabled by default):

# Basic 会话 python3 {baseDir}/scripts/browserbase_管理器.py 创建-会话

# 会话 with saved 上下文 (persist=true saves cookies on close) python3 {baseDir}/scripts/browserbase_管理器.py 创建-会话 --上下文-id github --persist

# Keep-alive 会话 for long re搜索 (survives disconnections) python3 {baseDir}/scripts/browserbase_管理器.py 创建-会话 --上下文-id github --persist --keep-alive --timeout 3600

# Full options python3 {baseDir}/scripts/browserbase_管理器.py 创建-会话 \ --上下文-id github \ --persist \ --keep-alive \ --timeout 3600 \ --region us-west-2 \ --proxy \ --block-ads \ --viewport-width 1280 \ --viewport-height 720

列出 all 会话s:

python3 {baseDir}/scripts/browserbase_管理器.py 列出-会话s python3 {baseDir}/scripts/browserbase_管理器.py 列出-会话s --状态 运行NING

获取 会话 detAIls:

python3 {baseDir}/scripts/browserbase_管理器.py 获取-会话 --会话-id

Terminate a 会话:

python3 {baseDir}/scripts/browserbase_管理器.py terminate-会话 --会话-id

Browser 自动化

Navigate to a URL:

# Navigate and 获取 page title python3 {baseDir}/scripts/browserbase_管理器.py navigate --会话-id --url "https://example.com"

# Navigate and 提取 text python3 {baseDir}/scripts/browserbase_管理器.py navigate --会话-id --url "https://example.com" --提取-text

# Navigate and save screenshot python3 {baseDir}/scripts/browserbase_管理器.py navigate --会话-id --url "https://example.com" --screenshot /tmp/page.png

# Navigate and take full-page screenshot python3 {baseDir}/scripts/browserbase_管理器.py navigate --会话-id --url "https://example.com" --screenshot /tmp/full.png --full-page

Take a screenshot of the current page (without navigating):

python3 {baseDir}/scripts/browserbase_管理器.py screenshot --会话-id --输出 /tmp/current.png python3 {baseDir}/scripts/browserbase_管理器.py screenshot --会话-id --输出 /tmp/full.png --full-page

执行 JavaScript:

python3 {baseDir}/scripts/browserbase_管理器.py 执行-js --会话-id --code "document.title"

获取 cookies:

python3 {baseDir}/scripts/browserbase_管理器.py 获取-cookies --会话-id

Recordings, 记录s & 调试

下载 a 会话 recording video (会话 must be terminated first):

python3 {baseDir}/scripts/browserbase_管理器.py 获取-recording --会话-id --输出 /tmp/会话.网页m

获取 会话 记录s:

python3 {baseDir}/scripts/browserbase_管理器.py g