An automated Chrome browser controlled via CLI, optimized for AI agents to perform web tasks with minimal token consumption.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ghost-browser
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 ghost-browser 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 Ghost Browser?
Ghost Browser is a specialized automation tool built on the nodriver engine, specifically designed to bridge the gap between AI agents and the web. Unlike traditional automation frameworks that rely on heavy HTML structures, this tool focuses on delivering LLM-optimized content like markdown summaries and numbered interactive element lists.
It enables Openclaw Skills to navigate complex websites, handle Cloudflare challenges, and manage persistent user sessions with high reliability and stealth. By prioritizing text-based interaction over fragile CSS selectors, it ensures that AI-driven workflows remain robust and cost-effective for developers building autonomous agents.
Ghost Browser Use Cases
- Automating complex multi-step web forms and secure logins.
- Scraping web content directly into clean markdown for LLM processing.
- Performing background research and data extraction without triggering bot detection.
- Managing persistent authenticated sessions across multiple AI agent tasks.
- Taking screenshots or generating PDFs of web pages for visual verification and reporting.
How Ghost Browser Works
- Initialize the browser daemon using the start command to launch a managed Chrome instance in either headed or headless mode.
- Navigate to a target URL and utilize the wait-ready command to ensure the DOM is stable and network activity has subsided.
- Execute page-summary to retrieve a low-token overview of the page structure, including element counts and metadata.
- Identify specific interactive elements through a numbered list, allowing the agent to target buttons or inputs by visible text labels.
- Perform actions such as clicking, typing, or form submission using human-like interaction patterns that bypass synthetic event detection.
- Extract the final page state as readable markdown or save the session state for future authenticated access.
Ghost Browser Setup
To get started with this component of your Openclaw Skills library, ensure Python 3.8+ and Google Chrome are installed on your system. Run the following command from the skill directory:
bash setup.sh
This script automatically configures a Python virtual environment and installs the necessary nodriver dependencies required for browser control.
Ghost Browser Data Schema & Taxonomy
The skill maintains a structured state directory to manage persistence and configuration across browser instances:
| Component | Path | Description |
|---|---|---|
| Browser State | state/browser.json | Tracks active process IDs, ports, and lifecycle status. |
| Profiles | state/profiles/ | Stores persistent Chrome user data, including history and extensions. |
| Sessions | state/sessions/ | JSON exports of cookies and local storage for specific domains. |
| Logs | state/browser.log | Detailed debug information and background process logs. |
Ghost Browser Advanced Features
- Built-in Cloudflare challenge solver (cf-solve) to programmatically bypass sophisticated bot protections.
- Stealth mode operations utilizing nodriver to avoid standard CDP detection signatures.
- Multi-profile management allowing for isolated browser environments and persistent history.
- Full session serialization to save and restore authentication states (cookies and localStorage) instantly.
- Background network and console logging for advanced debugging of failing web requests or JavaScript errors.
SKILL.md
Loading
Related Openclaw Skills
ClawdWallet
A multi-chain Web3 wallet Chrome extension that allows AI agents to manage crypto assets and sign transactions across 20+ blockchains.
whisnap
A powerful macOS command-line interface for transcribing audio and video files using local Whisper models or high-speed cloud processing.
SONA
SONA is an autonomous Solana wallet agent that combines AI-driven reasoning with Rust-enforced safety protocols to manage on-chain transactions securely.
OpenClaw Session Cleanup
A maintenance and stability skill designed to prune stale sessions and optimize resource usage for long-running OpenClaw deployments.
ghostfetch
A lightweight CLI tool for AI agents to search the web, fetch content as clean Markdown, and extract links without a full browser.
Ghost Browser
An AI-optimized automated Chrome browser that uses nodriver for efficient web tasks with minimal token consumption.
METADATA
Featured*
