captcha-relay
Human-in-the-loop CAPTCHA solving with two modes: screenshot (default, zero infrastructure) and token relay (requires network access). Screenshot mode captures the page with a grid overlay, sends it to the human, and injects clicks based on their reply. Token relay mode detects CAPTCHA type + sitekey, serves the real widget on a relay page for native solving, and injects the token via CDP.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/0xclanky/captcha-relayWhat This Skill Does
The captcha-relay skill provides a robust, human-in-the-loop solution for bypassing CAPTCHA challenges during browser automation. It serves as an essential bridge when automated solvers fail or when high-risk sites require manual intervention. The skill operates in two distinct modes: Screenshot Mode, which uses a grid-based visual overlay to guide human clicks, and Token Relay Mode, which serves the native CAPTCHA widget directly to a remote browser for high-success token generation.
Installation
You can install the skill directly via the command line interface using the OpenClaw manager:
clawhub install openclaw/skills/skills/0xclanky/captcha-relay
Ensure you have the required CDP port open and configured within your browser instance before initializing the skill.
Use Cases
- Screenshot Mode: Ideal for rapid deployment where infrastructure is limited. It is perfect for irregular challenges such as sliders, text-based puzzles, or unique platform-specific verification methods where native widget interception isn't possible.
- Token Relay Mode: The preferred choice for standard challenges like Google reCAPTCHA v2/v3, Cloudflare Turnstile, and hCaptcha. By serving the widget natively, it ensures the resulting token is identical to one generated by a standard user, minimizing the risk of automated detection.
Example Prompts
- "I am stuck on an hCaptcha at the login page. Can you initialize captcha-relay in screenshot mode and send the grid to Telegram?"
- "Configure the browser for token relay mode. The site uses Turnstile, and I have my Tailscale tunnel active to handle the incoming request."
- "Solve the current CAPTCHA on the registration form using the screenshot method, but do not inject the clicks automatically—just provide the coordinates."
Tips & Limitations
When using Screenshot Mode, ensure your browser window size remains consistent; resizing the window after generating the grid will cause click injection to fail. For Token Relay Mode, the skill relies on network connectivity. If you are behind a strict corporate firewall, ensure you have enabled tunneling via localtunnel or configured your Tailscale network correctly. Always keep the --timeout setting appropriate for the task; setting it too low may cause the skill to abandon a complex challenge before the human responder can provide input. For production-grade scraping, prefer Token Relay Mode as it offers significantly higher success rates for popular CAPTCHA providers.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-0xclanky-captcha-relay": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-read, code-execution