A high-performance stealth browser skill designed for AI agents to bypass anti-bot protections and perform human-like web automation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install freeman-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 freeman-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 Freeman Browser?
Freeman Browser is a sophisticated automation layer for Openclaw Skills that serves as a drop-in replacement for standard Playwright or Puppeteer implementations. It is specifically engineered to allow AI agents to navigate the modern web without being detected as bots. By spoofing fingerprints—such as device headers for an iPhone 15 Pro, touch events, and non-linear mouse movements—it successfully bypasses aggressive security measures like Cloudflare, DataDome, and PerimeterX.
This skill goes beyond simple navigation by offering a suite of human-mimetic interaction helpers. It handles the nuances of modern web architecture, including piercing Shadow DOMs and interacting with complex rich text editors, making it an indispensable tool for developers building agents that require deep web integration, research capabilities, or social media automation.
Freeman Browser Use Cases
- Scraping high-security websites protected by Cloudflare or anti-bot shields.
- Automating login and interaction workflows on social media platforms like LinkedIn, Reddit, and Instagram.
- Performing competitive research and price monitoring on e-commerce sites like Amazon.
- Accessing geo-restricted content by spoofing specific timezones and coordinates.
- Interacting with modern web components and Shadow DOM forms that standard scrapers cannot find.
How Freeman Browser Works
- The agent initializes the browser using the launchFreeman function which generates a stealthy execution context.
- The system applies a predefined or custom fingerprint including user-agent, viewport size, and hardware concurrency settings.
- Navigation is performed with human-like delays and network idle checks to ensure page stability.
- Interaction helpers generate Bezier-curve mouse movements and variable-rate typing to simulate real user behavior.
- If encountered, the skill utilizes integrated solvers to bypass CAPTCHA challenges or complex form validations.
- Session state, including cookies and local storage, is managed to maintain persistent logins across multiple agent runs.
Freeman Browser Setup
To integrate this into your workflow with Openclaw Skills, ensure the scripts are accessible in your agent directory.
# Install the browser dependencies
npm install playwright
# Reference the skill in your agent code
const { launchFreeman } = require('./.agents/skills/freeman-browser/scripts/browser-freeman');
You can optionally create a browser.json file in your working directory to customize the environment:
{
"locale": "en-US",
"timezoneId": "America/New_York",
"geolocation": {
"latitude": 40.7128,
"longitude": -74.006,
"accuracy": 50
}
}
Freeman Browser Data Schema & Taxonomy
The skill organizes its configuration and session data using standard JSON formats for interoperability within Openclaw Skills.
| Data Point | Format | Description |
|---|---|---|
| Fingerprint | Object | Includes platform, hardwareConcurrency, and navigator.webdriver status. |
| Interaction | Helpers | Functional utilities for humanType, humanClick, and humanScroll. |
| Session | JSON | Exportable cookie and storage state for persistent authentication. |
| Selectors | String | Support for standard CSS, Playwright locators, and Shadow DOM piercing strings. |
Freeman Browser Advanced Features
- Universal Shadow DOM traversal for deep-querying elements in React and Web Component apps.
- Network request interception to block analytics, modify headers, or mock API responses.
- Dedicated support for rich text editors including Lexical, ProseMirror, Quill, and Draft.js via clipboard injection.
- Integrated 2captcha support for automated CAPTCHA solving during high-friction workflows.
- Toggleable Desktop/Mobile modes to adapt to site-specific responsive bot detection rules.
SKILL.md
Loading
Related Openclaw Skills
Codex CLI Task (Async)
An asynchronous orchestration skill for OpenAI Codex that executes complex background tasks and delivers results directly to your preferred messaging channel.
nmap-mcp
A specialized MCP server wrapping nmap to provide structured, scoped, and logged network scanning tools for AI agents.
Calendar ICS Import
A specialized skill for generating valid iCalendar (.ics) files to bridge the gap between AI agents and personal calendar applications.
Agent World
A multi-agent social simulation where AI agents live, interact, and evolve in a shared virtual world.
Granola Sync
A powerful integration to sync, store, and query Granola meeting transcripts and AI summaries locally.
Custom SMTP Sender
A robust CLI tool for sending professional emails with Markdown support, attachments, and automated retry logic.
Featured*
