核心用法
browserbase-sessions 是一款面向自动化场景的云端浏览器管理工具，基于 Browserbase 平台构建。其核心能力围绕「持久化浏览器会话」展开：通过 Workspace（工作区）机制将浏览器状态（Cookies、Local Storage、标签页快照）跨对话保存，实现「今天登录、明天继续」的无缝体验。
显著优点
1. 会话持久化：借助 Browserbase Context，登录状态可长期保留，避免重复 MFA/登录流程。
2. 人机协同：提供实时的 human_handoff.share_url 远程调试链接，用户可手动浏览同时 AI 继续执行脚本。
3. 自动化原生：内置验证码自动解析（CAPTCHA solving）、会话录制（rrweb 事件回放）、广告拦截、代理支持等企业级功能。
4. 多站点工作流：单一 Context 可同时保持多个站点登录态，支持「Site A → Site B」跨站任务流。
5. Workspace 抽象：封装了「创建-启动-快照-恢复-停止」的完整生命周期，降低会话管理心智负担。
潜在缺点与局限性
- 成本敏感：Keep-alive 会话按运行时长计费（上限 6 小时），高频长会话可能触及套餐限额。
- 非无限期运行：Browserbase 强制 5 分钟连接超时与 6 小时最大会话时长，无法真正「永久在线」。
- 历史记录限制：仅能恢复「打开的 URL 列表」，无法还原完整的浏览器前进/后退历史栈。
- MFA 仍需人工：无法自主绕过 SSO/MFA，首次登录或敏感操作时需用户通过 live debugger 协助完成。
- 视频回放非直接下载：API 返回 rrweb JSON 事件而非 MP4，需额外处理才能可视化回放。
适合人群
- 需抓取需登录态的站点（如 LinkedIn、GitHub Enterprise、内部 CRM）的数据工程师
- 构建多步骤审批/填报自动化的 RPA 开发者
- 希望减少重复登录摩擦的 AI Agent 构建者
- 需要人机协同调试（边聊边浏览）的交互式场景
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| **凭据泄露** | `BROWSERBASE_API_KEY` 泄露可导致账户被盗用 | 使用环境变量或 OpenClaw 配置，避免硬编码；定期轮换密钥 |
| **会话劫持** | `human_handoff.share_url` 为公开链接，可能被截获 | 仅在工作必要时生成，完成后立即 `stop-workspace` 销毁会话 |
| **成本失控** | 长时 keep-alive 会话或高频并发易超配额 | 设置合理 `--timeout`，定期审查 Dashboard 用量 |
| **数据驻留** | 云端浏览器运行于 Browserbase 基础设施，敏感页面内容流经第三方 | 评估数据合规要求，必要时启用代理或区域选择（`--region`） |
技术栈与依赖
- 运行时：Python 3 + Playwright（Chromium）
- 关键环境变量：
BROWSERBASE_API_KEY、BROWSERBASE_PROJECT_ID - 本地状态：
~/.browserbase/workspaces/<name>.json存储 Context ID、Session ID 与标签页快照 - 开源许可：MIT