跳到主内容
智客 ZICQ

技能库 智客分类:开发工程 browserbase-sessions OpenClaw

Browserbase Sessions

创建并管理持续浏览器云浏览器会话,并具有认证持久性. 当用户需要自动化浏览器,在交互中保持登录会话,刮去认证的页面,或管理云浏览器实例时使用. 处理会话创建,基于上下文的认证持久性,保持动态重联,卡普查解析,会话记录,截图和会话清理.

54 安装量 · 2 星标

官方网址:ClawHub

技能介绍

先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。

做什么

创建和管理持久性 有认证持久性的浏览器云浏览器会话

何时用

用户需要将浏览器自动化,在交互中保持登录会话,刮去认证的页面,或管理云浏览器实例。 处理会话创建,基于上下文的认证持续,保持动态重联,卡普查解析,会话记录,截图,

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:Browserbase Sessions Skill、First-Time Setup、Step 1 — Get your Browserbase credentials、Step 2 — Install dependencies、Step 3 — Set environment variables、Step 4 — Run the setup test。 其中含规范建议的小节:分步指令。

文件分析

文件分析:除 SKILL.md 外,正文引用了 scripts/browserbase_manager.py,属于带资源的技能包,这些文件按需再读。

官方 description(原文)

Create and manage persistent Browserbase cloud browser sessions with authentication persistence. Use when the user needs to automate browsers, maintain logged-in sessions across interactions, scrape authenticated pages, or manage cloud browser instances. Handles session creation, context-based auth persistence, keep-alive reconnection, captcha solving, session recording, screenshots, and session cleanup.

Browserbase Sessions SkillFirst-Time SetupStep 1 — Get your Browserbase credentialsStep 2 — Install dependenciesStep 3 — Set environment variablesStep 4 — Run the setup testDefaultsAvailable CommandsSetup & ValidationContext Management (for authentication persistence)Session LifecycleBasic session

· 许可:MIT

来源分类:ClawHub Browser

SKILL.md 与 Agent 调用

官方规范 ↗
name
browserbase-sessions
description
Create and manage persistent Browserbase cloud browser sessions with authentication persistence. Use when the user needs to automate browsers, maintain logged-in sessions across interactions, scrape authenticated pages, or manage cloud browser instances. Handles session creation, context-based auth persistence, keep-alive reconnection, captcha solving, session recording, screenshots, and session cleanup.
许可
MIT
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。
指令中引用的文件 · 1
  • scripts/browserbase_manager.py

以下路径提取自原文;文件是否齐全请以来源仓库中的完整目录为准。

具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。

该技能引用了附属文件,请从来源获取完整目录;仅复制 SKILL.md 可能缺少依赖。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。

把 Agent Skill「browserbase-sessions」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-e03d8ebb7006e6f9-%E6%B5%8F%E8%A7%88%E5%99%A8%E4%BC%9A%E8%AF%9D.html
请存为 .cursor/skills/browserbase-sessions/SKILL.md 或 .claude/skills/browserbase-sessions/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。
该技能还带 scripts/、references/、assets/ 等文件,请从 https://clawhub.ai/skills/browserbase 取完整目录,不要只建一个 SKILL.md。

当前没有明确的 GitHub 技能包地址,请按来源页面的安装器说明操作。

ClawHub ↗

阅读排版
--- name: browserbase-sessions description: Create and manage persistent Browserbase cloud browser sessions with authentication persistence. Use when the user needs to automate browsers, maintain logged-in sessions across interactions, scrape authenticated pages, or manage cloud browser instances. Handles session creation, context-based auth persistence, keep-alive reconnection, captcha solving, session recording, screenshots, and session cleanup. license: MIT metadata: author: custom version: "2.0.0" openclaw: emoji: "🌐" requires: bins: ["python3"] anyBins: ["uv", "pip"] env: ["BROWSERBASE_API_KEY", "BROWSERBASE_PROJECT_ID"] primaryEnv: "BROWSERBASE_API_KEY" --- # Browserbase Sessions Skill Manage persistent cloud browser sessions via Browserbase. This skill creates browser sessions that preserve authentication (cookies, local storage) across interactions, automatically solve CAPTCHAs, and record sessions for later review. ## First-Time Setup ### Step 1 — Get your Browserbase credentials 1. Sign up at [browserbase.com](https://www.browserbase.com/) if you haven't already. 2. Go to **Settings → API Keys** and copy your API key (starts with `bb_live_`). 3. Go to **Settings → Project** and copy your Project ID (a UUID). ### Step 2 — Install dependencies ```bash cd {baseDir}/scripts && pip install -r requirements.txt playwright install chromium ``` Or with uv: ```bash cd {baseDir}/scripts && uv pip install -r requirements.txt uv run playwright install chromium ``` ### Step 3 — Set environment variables ```bash export BROWSERBASE_API_KEY="bb_live_your_key_here" export BROWSERBASE_PROJECT_ID="your-project-uuid-here" ``` Or configure via OpenClaw's `skills.entries.browserbase-sessions.env` in `~/.openclaw/openclaw.json`. ### Step 4 — Run the setup test This validates everything end-to-end (credentials, SDK, Playwright, API connection, and a live smoke test): ```bash python3 {baseDir}/scripts/browserbase_manager.py setup ``` You should see `"status": "success"` with all steps passing. If any step fails, the error message tells you exactly what to fix. ## Defaults Every session is created with these defaults to support research workflows: - **Captcha solving: ON** — Browserbase automatically solves CAPTCHAs so login flows and protected pages work without manual intervention. Disable with `--no-solve-captchas`. - **Session recording: ON** — Every session is recorded as a video you can download later for review or sharing. Disable with `--no-record`. - **Auth persistence** — Use contexts with `--persist` to stay logged in across sessions. ## Available Commands All commands are run via the manager script: ```bash python3 {baseDir}/scripts/browserbase_manager.py [options] ``` ### Setup & Validation Run the full setup test: ```bash python3 {baseDir}/scripts/browserbase_manager.py setup ``` ### Context Management (for authentication persistence) Create a named context to store login state: ```bash python3 {baseDir}/scripts/browserbase_manager.py create-context --name github ``` List all saved contexts: ```bash python3 {baseDir}/scripts/browserbase_manager.py list-contexts ``` Delete a context (by name or ID): ```bash python3 {baseDir}/scripts/browserbase_manager.py delete-context --context-id github ``` ### Session Lifecycle Create a new session (captcha solving and recording enabled by default): ```bash # Basic session python3 {baseDir}/scripts/browserbase_manager.py create-session # Session with saved context (persist=true saves cookies on close) python3 {baseDir}/scripts/browserbase_manager.py create-session --context-id github --persist # Keep-alive session for long research (survives disconnections) python3 {baseDir}/scripts/browserbase_manager.py create-session --context-id github --persist --keep-alive --timeout 3600 # Full options python3 {baseDir}/scripts/browserbase_manager.py create-session \ --context-id github \ --persist \ --keep-alive \ --timeout 3600 \ --region us-west-2 \ --proxy \ --block-ads \ --viewport-width 1280 \ --viewport-height 720 ``` List all sessions: ```bash python3 {baseDir}/scripts/browserbase_manager.py list-sessions python3 {baseDir}/scripts/browserbase_manager.py list-sessions --status RUNNING ``` Get session details: ```bash python3 {baseDir}/scripts/browserbase_manager.py get-session --session-id ``` Terminate a session: ```bash python3 {baseDir}/scripts/browserbase_manager.py terminate-session --session-id ``` ### Browser Automation Navigate to a URL: ```bash # Navigate and get page title python3 {baseDir}/scripts/browserbase_manager.py navigate --session-id --url "https://example.com" # Navigate and extract text python3 {baseDir}/scripts/browserbase_manager.py navigate --session-id --url "https://example.com" --extract-text # Navigate and save screenshot python3 {baseDir}/scripts/browserbase_manager.py navigate --session-id --url "https://example.com" --screenshot /tmp/page.png # Navigate and take full-page screenshot python3 {baseDir}/scripts/browserbase_manager.py navigate --session-id --url "https://example.com" --screenshot /tmp/full.png --full-page ``` Take a screenshot of the current page (without navigating): ```bash python3 {baseDir}/scripts/browserbase_manager.py screenshot --session-id --output /tmp/current.png python3 {baseDir}/scripts/browserbase_manager.py screenshot --session-id --output /tmp/full.png --full-page ``` Execute JavaScript: ```bash python3 {baseDir}/scripts/browserbase_manager.py execute-js --session-id --code "document.title" ``` Get cookies: ```bash python3 {baseDir}/scripts/browserbase_manager.py get-cookies --session-id ``` ### Recordings, Logs & Debug Download a session recording video (session must be terminated first): ```bash python3 {baseDir}/scripts/browserbase_manager.py get-recording --session-id --output /tmp/session.webm ``` Get session logs: ```bash python3 {baseDir}/scripts/browserbase_manager.py get-logs --session-id ``` Get the live debug URL (for visual inspection of a running session): ```bash python3 {baseDir}/scripts/browserbase_manager.py live-url --session-id ``` ## Common Workflows ### Workflow 1: Multi-session research with persistent login ```bash # 1. One-time: create a named context for the site python3 {baseDir}/scripts/browserbase_manager.py create-context --name myapp # 2. Start a research session (captchas auto-solved, recording on) python3 {baseDir}/scripts/browserbase_manager.py create-session --context-id myapp --persist --keep-alive --timeout 3600 # 3. Navigate to login — captchas solved automatically python3 {baseDir}/scripts/browserbase_manager.py navigate --session-id --url "https://myapp.com/login" # Use execute-js to fill forms and submit # 4. Do research, take screenshots python3 {baseDir}/scripts/browserbase_manager.py navigate --session-id --url "https://myapp.com/dashboard" --extract-text python3 {baseDir}/scripts/browserbase_manager.py screenshot --session-id --output /tmp/dashboard.png # 5. Terminate (cookies saved to context) python3 {baseDir}/scripts/browserbase_manager.py terminate-session --session-id # 6. Download recording to share python3 {baseDir}/scripts/browserbase_manager.py get-recording --session-id --output /tmp/research.webm # 7. Next day: new session, already logged in! python3 {baseDir}/scripts/browserbase_manager.py create-session --context-id myapp --persist --keep-alive --timeout 3600 ``` ### Workflow 2: Screenshot documentation ```bash python3 {baseDir}/scripts/browserbase_manager.py create-session python3 {baseDir}/scripts/browserbase_manager.py navigate --session-id --url "https://docs.example.com" --screenshot /tmp/docs_home.png python3 {baseDir}/scripts/browserbase_manager.py navigate --session-id --url "https://docs.example.com/api" --screenshot /tmp/docs_api.png --full-page python3 {baseDir}/scripts/browserbase_manager.py terminate-session --session-id ``` ### Workflow 3: Record and share a walkthrough ```bash # Session recording is ON by default python3 {baseDir}/scripts/browserbase_manager.py create-session --context-id myapp --persist # ... do your walkthrough (navigate, click, etc.) ... python3 {baseDir}/scripts/browserbase_manager.py terminate-session --session-id # Download the video python3 {baseDir}/scripts/browserbase_manager.py get-recording --session-id --output /tmp/walkthrough.webm ``` ## Important Notes - **Captcha solving is ON by default.** Browserbase handles CAPTCHAs automatically during login flows and page loads. Use `--no-solve-captchas` to disable. - **Recording is ON by default.** Every session is recorded. Download with `get-recording` after termination. Use `--no-record` to disable. - **Connection timeout**: 5 minutes to connect after creation before auto-termination. - **Keep-alive sessions** survive disconnections and must be explicitly terminated. - **Context persistence**: Wait a few seconds after `terminate-session --persist` before creating a new session with the same context. - **Named contexts**: Use `--name` with `create-context` to save friendly names (e.g. `github`, `slack`). Use the name anywhere a context ID is expected. - **One context per site**: Use separate contexts for different authenticated sites. - **Avoid concurrent sessions on the same context**. - **Regions**: us-west-2 (default), us-east-1, eu-central-1, ap-southeast-1. - **Session timeout**: 60–21600 seconds (max 6 hours). ## Error Handling All commands return JSON output. On error, the output includes an `"error"` key. Common errors: - `APIConnectionError`: Browserbase API unreachable - `RateLimitError`: Too many concurrent sessions for your plan - `APIStatusError`: Invalid parameters or authentication failure - Missing env vars: Set `BROWSERBASE_API_KEY` and `BROWSERBASE_PROJECT_ID` ## Reference For full API details, read `{baseDir}/references/api-quick-ref.md`.

相关技能

开发工程

Github

使用`gh' CLI与 GitHub 进行互动。 使用`gh问题 ' 、`gh pr ' 、`gh run ' 和`gh api'处理问题、公关、CI运行和高级询问.

开发工程

Elite Longterm Memory

Cursor, Claude, ChatGPT & Copilot的终极AI代理内存系统. WAL协议+向量搜索+git-notes+云备份. 永远不要失去背景。 维比编码准备好了.

开发工程

Answeroverflow

通过Answer Overflow搜索索引的Discord社区讨论. 寻找只存在于Discord对话中的编码问题、库问题和社区QQA的解决方案.

开发工程

Git Essentials

基本内容 Git 命令和工作流程用于版本控制,分支,以及协作.