docs: add Browserbase as hosted remote CDP option

Add Browserbase documentation section alongside the existing Browserless
section in the browser docs. Includes signup instructions, CDP connection
configuration, and environment variable setup for both English and Chinese
(zh-CN) translations.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Shrey Pandya
2026-03-01 16:06:05 -08:00
committed by Peter Steinberger
parent 3ada30e670
commit 885199dcaa
2 changed files with 146 additions and 0 deletions

View File

@@ -196,6 +196,87 @@ Notes:
- Replace `<BROWSERLESS_API_KEY>` with your real Browserless token.
- Choose the region endpoint that matches your Browserless account (see their docs).
## Browserbase (hosted remote CDP)
[Browserbase](https://www.browserbase.com) is a cloud platform for running
headless browsers. It provides remote CDP endpoints with built-in CAPTCHA
solving, anti-bot stealth mode, and residential proxies. You can point an
OpenClaw browser profile at a Browserbase session and authenticate with your
API key.
### Getting started
1. **Sign up** at [browserbase.com/sign-up](https://www.browserbase.com/sign-up).
The free tier includes one concurrent browser session and 60 minutes of
monthly usage.
2. **Find your credentials** on the
[Overview dashboard](https://www.browserbase.com/overview) — copy your
**API Key** and **Project ID** from the right-hand panel.
3. **Create a session** using the Browserbase API (or their SDK) and retrieve
the CDP connect URL.
### Configuration
Browserbase sessions expose a WebSocket CDP endpoint. Point a profile at it:
```json5
{
browser: {
enabled: true,
defaultProfile: "browserbase",
remoteCdpTimeoutMs: 3000,
remoteCdpHandshakeTimeoutMs: 5000,
profiles: {
browserbase: {
cdpUrl: "wss://connect.browserbase.com?apiKey=<BROWSERBASE_API_KEY>",
color: "#F97316",
},
},
},
}
```
If you create sessions through the Browserbase Sessions API, each session
returns its own `connectUrl`. You can use that directly:
```json5
{
browser: {
profiles: {
browserbase: {
cdpUrl: "<SESSION_CONNECT_URL>",
color: "#F97316",
},
},
},
}
```
### Environment variables
Store your credentials in environment variables instead of committing them to
config:
```bash
export BROWSERBASE_API_KEY="bb_live_..."
export BROWSERBASE_PROJECT_ID="your-project-id"
```
Then reference them in your profile or create sessions programmatically.
### Notes
- Replace `<BROWSERBASE_API_KEY>` with your real Browserbase API key (starts
with `bb_live_`).
- The free tier allows one concurrent session and 60 minutes per month. Paid
plans offer higher concurrency and usage limits.
- Browserbase sessions include automatic CAPTCHA solving and anti-bot stealth
by default — no extra configuration needed.
- Sessions can be monitored live at
`https://www.browserbase.com/sessions/<SESSION_ID>`.
- See the [Browserbase docs](https://docs.browserbase.com) for full API
reference, SDK guides, and integration examples.
## Security
Key ideas:

View File

@@ -178,6 +178,71 @@ OpenClaw 在调用 `/json/*` 端点和连接 CDP WebSocket 时会保留认证信
-`<BROWSERLESS_API_KEY>` 替换为你真实的 Browserless 令牌。
- 选择与你的 Browserless 账户匹配的区域端点(请参阅其文档)。
## Browserbase托管远程 CDP
[Browserbase](https://www.browserbase.com) 是一个云平台,用于运行无头浏览器。它提供远程 CDP 端点,内置验证码自动解决、反机器人隐身模式和住宅代理。你可以将 OpenClaw 浏览器配置文件指向 Browserbase 会话,并使用你的 API 密钥进行认证。
### 快速开始
1. 在 [browserbase.com/sign-up](https://www.browserbase.com/sign-up) **注册**。免费版包含一个并发浏览器会话和每月 60 分钟的使用时间。
2. 在[概览面板](https://www.browserbase.com/overview)中**查找你的凭据** — 从右侧面板复制你的 **API Key****Project ID**
3. 使用 Browserbase API或其 SDK**创建会话**,并获取 CDP 连接 URL。
### 配置
Browserbase 会话暴露 WebSocket CDP 端点。将配置文件指向它:
```json5
{
browser: {
enabled: true,
defaultProfile: "browserbase",
remoteCdpTimeoutMs: 3000,
remoteCdpHandshakeTimeoutMs: 5000,
profiles: {
browserbase: {
cdpUrl: "wss://connect.browserbase.com?apiKey=<BROWSERBASE_API_KEY>",
color: "#F97316",
},
},
},
}
```
如果你通过 Browserbase Sessions API 创建会话,每个会话会返回自己的 `connectUrl`。你可以直接使用:
```json5
{
browser: {
profiles: {
browserbase: {
cdpUrl: "<SESSION_CONNECT_URL>",
color: "#F97316",
},
},
},
}
```
### 环境变量
将凭据存储在环境变量中,而不是提交到配置文件:
```bash
export BROWSERBASE_API_KEY="bb_live_..."
export BROWSERBASE_PROJECT_ID="your-project-id"
```
然后在配置文件中引用它们,或以编程方式创建会话。
### 注意事项
-`<BROWSERBASE_API_KEY>` 替换为你真实的 Browserbase API 密钥(以 `bb_live_` 开头)。
- 免费版允许一个并发会话和每月 60 分钟。付费计划提供更高的并发数和使用限额。
- Browserbase 会话默认包含自动验证码解决和反机器人隐身功能 — 无需额外配置。
- 可以在 `https://www.browserbase.com/sessions/<SESSION_ID>` 实时监控会话。
- 请参阅 [Browserbase 文档](https://docs.browserbase.com) 获取完整的 API 参考、SDK 指南和集成示例。
## 安全性
核心理念: