A high-performance WebDriver CLI designed for AI-driven browser control, session persistence, and automated web interactions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install browserctl
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install browserctl using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is browsectl?
browsectl is a specialized command-line interface that bridges the gap between AI agents and web browsers. As a core component of Openclaw Skills, it provides granular control over WebDriver sessions, enabling automated navigation, element interaction, and data extraction. By persisting sessions and providing a robust REPL, it allows developers and AI agents to maintain state across multiple invocations, making it ideal for complex multi-step web workflows.
The tool is designed to simplify the lifecycle of browser automation by handling driver detection and binary management automatically. Whether you are running headless tests or interactive sessions, this tool ensures that your AI agents have a reliable interface for web-based tasks.
browsectl Use Cases
- Automating repetitive web tasks through AI-driven command sequences.
- Capturing screenshots of specific DOM elements for visual verification and testing.
- Scoping and extracting content from chat-based UIs using specialized last-message selectors.
- Managing multiple browser profiles and persistent sessions across different Openclaw Skills projects.
- Performing batch execution of complex web interactions defined in JSON configuration files.
How browsectl Works
- Initialize the environment by running the setup command to detect installed browsers and download the appropriate WebDriver binaries.
- Start the WebDriver server and create a persistent browser session that is saved to the local configuration directory.
- Navigate to target URLs and interact with page elements using advanced CSS selectors or regex-based text filters.
- Manage multiple tabs and browser states using the built-in tab management commands to handle complex multi-page workflows.
- Execute automated workflows either via direct CLI commands, batch JSON files, or the interactive REPL for real-time control.
browsectl Setup
To get started with browsectl as part of your Openclaw Skills toolkit, install the package via npm and run the initial setup:
npm install -g @yorelog/browsectl
browsectl setup
Once setup is complete, you can start the driver and create a session:
browsectl driver-start
browsectl session-create
browsectl Data Schema & Taxonomy
The skill organizes its operational data and metadata as follows:
| Component | Format | Storage Location / Detail |
|---|---|---|
| Session Registry | JSON | Stored in .browsectl/sessions.json for persistence across runs |
| User Profiles | File System | Browser user data stored in ~/.browsectl/<browser>-profile |
| Selector Syntax | String | Enhanced CSS syntax including ::text(/regex/flags) extensions |
| Output Formats | Binary/Text | Screenshots as PNG and content extraction as raw text |
| Configuration | CLI Flags | Global flags for viewport, headless mode, and binary paths |
browsectl Advanced Features
- Persistent session management that allows AI agents to resume work without re-authenticating or restarting browsers.
- Advanced selector syntax with regex-based text filtering to accurately target dynamic web elements.
- Clipboard simulation for typing text character-by-character or pasting via clipboard to bypass bot detection.
- Parallel and sequential batch execution modes for high-throughput automation tasks.
- Comprehensive interactive REPL with tab-completion and command history for live debugging.
- Multi-browser and multi-platform support covering Chrome and Edge on Windows, macOS, and Linux.
SKILL.md
Loading
Related Openclaw Skills
Quarterly Party Building and Administration Analysis
An AI-driven analytical tool that collects and synthesizes quarterly political speeches, official meetings, and theoretical articles into structured reports.
TikTok Shop Ad Library & Analytics
A specialized AI agent skill designed to bridge TikTok creative ad research with real-time TikTok Shop product and store performance metrics.
TikTok Ad Tracker & Monitor
A comprehensive competitive intelligence skill for tracking TikTok ad creatives, monitoring advertiser changes, and analyzing market trends through the PipiAds ecosystem.
AI Free Image to Video Generator
A powerful AI agent skill that transforms static images into cinematic, high-definition video clips using intelligent motion synthesis.
Research Paper to PPT v2
A specialized automation skill that converts medical research papers into structured PowerPoint presentations including original figures and scientific outlines.
Lensmor Recommendations
Get an AI-ranked list of exhibitors matching your Ideal Customer Profile at any trade show to prioritize outreach and lead generation.
Featured*
