Fix OpenClaw Browser CAPTCHAs with GateSolve MCP (100 Free Solves)

Your OpenClaw agent's browser keeps hitting CAPTCHAs. Here's how to solve them automatically with GateSolve's MCP server — no manual intervention, no CapSolver account, 100 free solves.

The Problem

OpenClaw gives AI agents a headless browser. That browser runs on a server with a datacenter IP. Cloudflare, reCAPTCHA, and hCaptcha see the datacenter ASN and throw up challenges. Your agent hits a wall.

The usual advice is to use Browser Relay (attach to a human browser session) or stealth plugins. But Browser Relay requires a human present, and stealth plugins are an arms race. When the CAPTCHA appears, you need a solver.

The Solution: GateSolve MCP Server

GateSolve exposes solve_captcha and detect_captcha as MCP tools. OpenClaw agents can call MCP tools natively. Connect them and your agent handles CAPTCHAs automatically.

Step 1: Add GateSolve to Your MCP Config

Add the GateSolve MCP server to your OpenClaw configuration:

// In your OpenClaw MCP config (openclaw.yaml or settings)
mcp:
  servers:
    gatesolve:
      command: npx
      args: ["@gatesolve/mcp-server"]
      env:
        GATESOLVE_API_KEY: "your_api_key_here"

Step 2: Get a Free API Key

Sign up for 100 free solves — no credit card required:

curl -X POST https://gatesolve.dev/api/waitlist \
  -H "Content-Type: application/json" \
  -d '{"email": "your@email.com"}'

# Response includes your API key: gs_...

Step 3: Use It in Your Agent

Once configured, your OpenClaw agent has two new tools available:

• detect_captcha — Check if a URL has a CAPTCHA before navigating
• solve_captcha — Submit a CAPTCHA for solving (Turnstile, reCAPTCHA v2/v3, hCaptcha)

The agent workflow looks like:

# Agent automatically calls these MCP tools when hitting CAPTCHAs:

1. Navigate to target URL
2. Hit Cloudflare Turnstile challenge
3. Call detect_captcha to identify the CAPTCHA type and siteKey
4. Call solve_captcha with type, siteKey, and pageUrl
5. Inject the returned token into the page
6. Continue with the original task

Alternative: Python SDK

If you prefer direct API calls from a custom OpenClaw skill:

pip install gatesolve

from gatesolve import solve

token = solve(
    type="cloudflare-turnstile",
    site_key="0x4AAAAAAA...",
    page_url="https://example.com",
    api_key="gs_your_key"
)

# Inject token into the page via browser tool
# document.querySelector('[name="cf-turnstile-response"]').value = token

Why Not CapSolver?

Supported CAPTCHA Types

• Cloudflare Turnstile — The most common block for OpenClaw browsers. $0.02/solve.
• reCAPTCHA v2 — Checkbox and invisible variants. $0.03/solve.
• reCAPTCHA v3 — Score-based, no visual challenge. $0.02/solve.
• hCaptcha — Common on privacy-focused sites. $0.03/solve.

How It Works Under the Hood

GateSolve solves CAPTCHAs remotely using a headless browser with anti-detection (Camoufox). Your agent never touches the CAPTCHA page directly — it sends the siteKey and pageUrl, and GateSolve returns a valid token.

This means the CAPTCHA provider sees a clean browser session from GateSolve's infrastructure, not your datacenter IP. The token is injected into your agent's page via JavaScript.

Get Started

Get your free API key at gatesolve.dev — 100 free solves, no credit card, 30-second setup.