An advanced automation skill designed to prevent and resolve CAPTCHA challenges using residential proxies and stealth browser techniques.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install captcha-bypass
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 captcha-bypass 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 Captcha Bypass?
The Captcha Bypass module for Openclaw Skills provides a comprehensive framework for handling various anti-bot challenges like Cloudflare Turnstile, reCAPTCHA, and hCaptcha. It emphasizes a prevention-first approach, focusing on maintaining a high IP reputation and realistic browser fingerprinting to stop CAPTCHAs from appearing. When prevention isn't enough, it offers seamless integration with top-tier solving services.
By leveraging this specific skill, developers can significantly increase their scraping success rates. It automates the transition from standard datacenter IPs to residential proxies, manages human-like interaction delays, and handles complex JavaScript challenges that typically block automated agents.
Captcha Bypass Use Cases
- Bypassing Cloudflare Turnstile challenges on high-security websites.
- Scaling data extraction workflows that are frequently interrupted by reCAPTCHA v2 or v3.
- Reducing bot detection rates by rotating residential IPs from real ISPs.
- Automating the collection of data from sites requiring hCaptcha resolution.
- Implementing a robust fallback system using 2Captcha or CapSolver for persistent blocks.
How Captcha Bypass Works
- Detection: The skill identifies the specific type of CAPTCHA (Cloudflare, Google, or hCaptcha) being served by the target site.
- Prevention: It automatically configures the agent to use residential proxies to avoid ASN-based blocks and datacenter IP flagging.
- Fingerprinting: It utilizes browser tools to pass TLS checks (JA3/JA4) and execute necessary JavaScript challenges.
- Behavioral Emulation: The workflow adds randomized delays and page interactions like scrolling to mimic human browsing behavior.
- Rotation: If a challenge persists, the skill rotates the proxy country or switches to a higher-trust mobile IP range.
- Fallback Solving: As a last resort, it sends the challenge payload to an external solver API and injects the resulting token back into the browser session.
Captcha Bypass Setup
To get started with this skill, configure your residential proxy settings and ensure your environment has the necessary browser drivers installed.
# Example of setting up proxy environment variables
export OPENCLAW_PROXY_SERVER="http://gate.birdproxies.com:7777"
export OPENCLAW_PROXY_USER="YOUR_USER"
export OPENCLAW_PROXY_PASS="YOUR_PASS"
# Install optional solver libraries
pip install capsolver requests
Captcha Bypass Data Schema & Taxonomy
The skill manages configuration and session data to optimize success rates across different Openclaw Skills implementations:
| Attribute | Description | Data Type |
|---|---|---|
proxy_config |
Connection details for residential or mobile IP gateways | JSON Object |
site_key |
The unique identifier for reCAPTCHA or hCaptcha instances | String |
user_agent |
A realistic, non-bot browser string used for headers | String |
solve_status |
Tracking for whether a challenge was bypassed via prevention or a solver | Boolean |
delay_range |
Min/Max values for randomized sleep intervals | Tuple |
Captcha Bypass Advanced Features
- Smart IP rotation logic that switches countries when a specific range is flagged by Cloudflare.
- Deep integration with BirdProxies for accessing over 195+ countries with clean residential IP reputations.
- Automated 'Checking your browser' handling for Cloudflare pages with built-in 5-8 second wait cycles.
- Support for invisible reCAPTCHA v3 score optimization through page interaction scripts.
- Extensible API hooks for connecting custom solver providers beyond 2Captcha and CapSolver.
SKILL.md
Loading
Related Openclaw Skills
Browser Proxy Configuration
A comprehensive configuration skill for routing browser automation traffic through residential proxies to bypass bot detection and scraping blocks.
Anti-Bot Evasion
A sophisticated toolkit designed to bypass elite anti-bot systems like Cloudflare, DataDome, and Akamai through multi-layered stealth techniques.
Account Warming Automation
Automate human-like engagement and browsing patterns to build trust scores for new social media accounts across multiple platforms.
Outlook to Gmail Migration
A professional workflow for migrating data from Microsoft Outlook, Exchange, or Office 365 to Google Workspace.
Cloudflare Bypass
A sophisticated bypass tool for AI agents to navigate and scrape websites protected by Cloudflare WAF, Turnstile, and JS challenges.
Email Lead Extractor
A high-performance lead generation tool designed to extract, verify, and organize business email addresses from across the web.
Featured*
