agent-browser-clawdbot

Use it when: your OpenClaw assistant has to work through a website in several steps: logging in, filling forms, using a web app
It does: drives a headless Chromium with Vercel's agent-browser CLI, acting on elements by short labels from snapshots of the page
You get: clicks, typing and navigation done for you, plus extracted text, attributes, screenshots or PDFs
Needs: the agent-browser CLI, installed from npm, and the Chromium it downloads
Unlike: Vercel's official agent-browser skill, which loads its instructions from the installed CLI; this is a community member's fixed command list

TLDR

OpenClaw, once called Clawdbot, is an open-source AI assistant you run yourself, and this community skill for it, by Yossi Elkrief, teaches it Vercel Labs' agent-browser CLI. The agent opens a page and takes a snapshot of its interactive elements as JSON, where each button or field gets a short label such as @e2. It then clicks, fills or reads by label, and takes a new snapshot whenever the page changes. The command list covers navigation, waiting (for an element, some text, a URL, the network to go quiet, or a JavaScript condition), checking whether elements are visible or checked, tabs and iframes, cookies and local storage, blocking or faking network requests, and screenshots and PDFs. Named sessions run isolated browsers side by side, say an admin and a regular user at once, and saved login state skips signing in again. The skill recommends it over the assistant's built-in browser for multi-step workflows and complex web apps, and the built-in one for visual inspection or browser extensions.

Summarizes the skill at aca4fea.

openclaw skills install @matrixy/agent-browser-clawdbot

ClawHub page · All skills from clawhub.ai/matrixy

Downloads: 156,494 on ClawHub, Sep 21, 2026
Downloads: 163,005 on Tencent SkillHub, Sep 21, 2026

Category	category:browser category:software-engineering Drive browsers, scrape pages and search the web. Everything for building software: planning, coding, debugging, design, frameworks, cloud, agents and skills.
Type	type:tool Operates a CLI, API, app or bundled script to get something done.
Effect	effect:remote Its own steps change something outside your machine: post, send, deploy, provision, file issues, drive a website, or upload data to a service.
Needs	needs:cli needs:browser needs:openclaw A specific command-line tool or desktop app must be installed, such as gh, agent-browser, LibreOffice, Obsidian or a vendor CLI. Drives a real Chromium or Chrome browser. Built for the OpenClaw agent.
Publisher	by:community Everyone else. Unverified vendor claims default to community.
Topics	browser-automation
Stack	stack:agent-browser

SKILL.md

From ClawHub, version 0.1.0. Checked daily, last changed Oct 20, 2026.

Frontmatter

name: agent-browser
description: Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection
metadata: {"clawdbot":{"emoji":"🌐","requires":{"commands":["agent-browser"]},"homepage":"https://github.com/vercel-labs/agent-browser"}}

Agent Browser Skill

Fast browser automation using accessibility tree snapshots with refs for deterministic element selection.

Why Use This Over Built-in Browser Tool

Use agent-browser when:

Automating multi-step workflows
Need deterministic element selection
Performance is critical
Working with complex SPAs
Need session isolation

Use built-in browser tool when:

Need screenshots/PDFs for analysis
Visual inspection required
Browser extension integration needed

Core Workflow

# 1. Navigate and snapshot
agent-browser open https://example.com
agent-browser snapshot -i --json

# 2. Parse refs from JSON, then interact
agent-browser click @e2
agent-browser fill @e3 "text"

# 3. Re-snapshot after page changes
agent-browser snapshot -i --json

Key Commands

Navigation

agent-browser open <url>
agent-browser back | forward | reload | close

Snapshot (Always use -i --json)

agent-browser snapshot -i --json          # Interactive elements, JSON output
agent-browser snapshot -i -c -d 5 --json  # + compact, depth limit
agent-browser snapshot -s "#main" -i      # Scope to selector

Interactions (Ref-based)

agent-browser click @e2
agent-browser fill @e3 "text"
agent-browser type @e3 "text"
agent-browser hover @e4
agent-browser check @e5 | uncheck @e5
agent-browser select @e6 "value"
agent-browser press "Enter"
agent-browser scroll down 500
agent-browser drag @e7 @e8

Get Information

agent-browser get text @e1 --json
agent-browser get html @e2 --json
agent-browser get value @e3 --json
agent-browser get attr @e4 "href" --json
agent-browser get title --json
agent-browser get url --json
agent-browser get count ".item" --json

Check State

agent-browser is visible @e2 --json
agent-browser is enabled @e3 --json
agent-browser is checked @e4 --json

Wait

agent-browser wait @e2                    # Wait for element
agent-browser wait 1000                   # Wait ms
agent-browser wait --text "Welcome"       # Wait for text
agent-browser wait --url "**/dashboard"   # Wait for URL
agent-browser wait --load networkidle     # Wait for network
agent-browser wait --fn "window.ready === true"

Sessions (Isolated Browsers)

agent-browser --session admin open site.com
agent-browser --session user open site.com
agent-browser session list
# Or via env: AGENT_BROWSER_SESSION=admin agent-browser ...

State Persistence

agent-browser state save auth.json        # Save cookies/storage
agent-browser state load auth.json        # Load (skip login)

Screenshots & PDFs

agent-browser screenshot page.png
agent-browser screenshot --full page.png
agent-browser pdf page.pdf

Network Control

agent-browser network route "**/ads/*" --abort           # Block
agent-browser network route "**/api/*" --body '{"x":1}'  # Mock
agent-browser network requests --filter api              # View

Cookies & Storage

agent-browser cookies                     # Get all
agent-browser cookies set name value
agent-browser storage local key           # Get localStorage
agent-browser storage local set key val

Tabs & Frames

agent-browser tab new https://example.com
agent-browser tab 2                       # Switch to tab
agent-browser frame @e5                   # Switch to iframe
agent-browser frame main                  # Back to main

Snapshot Output Format

{
  "success": true,
  "data": {
    "snapshot": "...",
    "refs": {
      "e1": {"role": "heading", "name": "Example Domain"},
      "e2": {"role": "button", "name": "Submit"},
      "e3": {"role": "textbox", "name": "Email"}
    }
  }
}

Best Practices

Always use -i flag - Focus on interactive elements
Always use --json - Easier to parse
Wait for stability - agent-browser wait --load networkidle
Save auth state - Skip login flows with state save/load
Use sessions - Isolate different browser contexts
Use --headed for debugging - See what's happening

Example: Search and Extract

agent-browser open https://www.google.com
agent-browser snapshot -i --json
# AI identifies search box @e1
agent-browser fill @e1 "AI agents"
agent-browser press Enter
agent-browser wait --load networkidle
agent-browser snapshot -i --json
# AI identifies result refs
agent-browser get text @e3 --json
agent-browser get attr @e4 "href" --json

Example: Multi-Session Testing

# Admin session
agent-browser --session admin open app.com
agent-browser --session admin state load admin-auth.json
agent-browser --session admin snapshot -i --json

# User session (simultaneous)
agent-browser --session user open app.com
agent-browser --session user state load user-auth.json
agent-browser --session user snapshot -i --json

Installation

npm install -g agent-browser
agent-browser install                     # Download Chromium
agent-browser install --with-deps         # Linux: + system deps

Credits

Skill created by Yossi Elkrief (@MaTriXy)

agent-browser CLI by Vercel Labs