2captcha

What This Skill Does

The 2Captcha skill provides a command-line interface for the 2Captcha human-powered solving service, enabling OpenClaw agents to programmatically bypass various types of anti-bot protections. It supports a wide range of CAPTCHA types, including standard image-based puzzles, Google reCAPTCHA (v2 and v3), hCaptcha, Cloudflare Turnstile, FunCaptcha (Arkose), and GeeTest. By automating the retrieval of solution tokens, this skill removes the manual burden of verifying human presence, allowing scripts and browser automation workflows to proceed uninterrupted.

Installation

To integrate this skill, use the ClawHub package manager:

clawhub install openclaw/skills/skills/adinvadim/2captcha

Additionally, ensure the CLI tool is available by running: curl -fsSL https://raw.githubusercontent.com/adinvadim/2captcha-cli/main/solve-captcha -o /usr/local/bin/solve-captcha && chmod +x /usr/local/bin/solve-captcha

Configure your environment by saving your API key to ~/.config/2captcha/api-key or setting the TWOCAPTCHA_API_KEY environment variable.

Use Cases

• Automated Web Scraping: Bypass obstacles when extracting public data from protected sites.
• Account Creation: Automate registration forms that include human-verification steps.
• Form Submission: Ensure automated lead generation or data entry workflows do not hang on captcha challenges.
• Continuous Testing: Integrate with test suites to verify that automated workflows can handle authentication gates.

Example Prompts

1. "Check my 2Captcha balance and let me know if I have enough credits to run today's scraping task."
2. "Solve the reCAPTCHA v2 on this registration page using sitekey 6Le-wvk... and URL https://example.com/register."
3. "Upload the captcha image from ./login_challenge.png to 2Captcha and return the text solution."

Tips & Limitations

• Cost Efficiency: Each solve incurs a small fee. Monitor your balance regularly using the balance command to avoid sudden failures in your automation pipeline.
• Parameters: Always ensure you have correctly identified the sitekey and page_url from the target website's source code, as these are mandatory for most modern token-based captchas.
• Error Handling: Implement retry logic for ERROR_NO_SLOT_AVAILABLE, which may occur during high-traffic periods for the service.
• Scope: This tool is strictly for legitimate automation tasks. Ensure your use complies with the terms of service of the target websites.