Skills captcha-relay

Name: captcha-relay
Author: openclaw

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

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/0xclanky/captcha-relay" ~/.claude/skills/openclaw-skills-captcha-relay && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/0xclanky/captcha-relay" ~/.openclaw/skills/openclaw-skills-captcha-relay && rm -rf "$T"

manifest: skills/0xclanky/captcha-relay/SKILL.md

CAPTCHA Relay v2

Solve CAPTCHAs by relaying them to a human. Two modes available.

Modes

Screenshot Mode (default) — No infrastructure needed

Grid overlay screenshot → send image to human via Telegram → human replies with cell numbers → inject clicks.

Zero setup beyond the skill itself. No Tailscale, no tunnels, no relay server.
Works for any CAPTCHA type (reCAPTCHA, hCaptcha, sliders, text, etc.)
Uses
```
sharp
```
for image processing + CDP for screenshots and click injection.

node index.js                       # screenshot mode (default)
node index.js --mode screenshot     # explicit
node index.js --screenshot          # legacy alias

const { solveCaptchaScreenshot } = require('./index');
const capture = await solveCaptchaScreenshot({ cdpPort: 18800 });
// capture.imagePath — annotated screenshot to send to human
// capture.prompt — text prompt for the human

Token Relay Mode — Requires network access

Detects CAPTCHA type + sitekey → serves real widget on relay page → human solves natively → token injected via CDP.

Requires Tailscale or a tunnel (localtunnel/cloudflared) so the human's device can reach the relay server.
Produces a proper CAPTCHA token — more reliable for reCAPTCHA v2, hCaptcha, Turnstile.
Best when you have Tailscale already set up.

node index.js --mode relay              # with localtunnel
node index.js --mode relay --no-tunnel  # with Tailscale/LAN

const { solveCaptcha } = require('./index');
const result = await solveCaptcha({ cdpPort: 18800, useTunnel: false });
// result.relayUrl — URL to send to human
// result.token — solved CAPTCHA token

When to Use Each

Scenario	Mode
Quick & easy, no setup	`screenshot`
Any CAPTCHA type (sliders, text, etc.)	`screenshot`
Known CAPTCHA with sitekey (reCAPTCHA, hCaptcha, Turnstile)	`relay`
Tailscale already configured	`relay`
No network access to host	`screenshot`

CLI Flags

Flag	Default	Description
`--mode screenshot\|relay`	`screenshot`	Select solving mode
`--screenshot`	—	Alias for `--mode screenshot`
`--no-inject`	inject	Return token without injecting into browser
`--no-tunnel`	tunnel	Skip tunnel, use local/Tailscale IP (relay mode)
`--timeout N`	120	Timeout in seconds
`--cdp-port N`	18800	Chrome DevTools Protocol port

Agent Workflow

Screenshot mode (simplest)

Call
```
solveCaptchaScreenshot({ cdpPort })
```
Send
```
capture.imagePath
```
to human via
```
message
```
tool with
```
capture.prompt
```
Human replies with cell numbers (e.g. "1,3,5,7")

Call

injectGridClicks(cdpPort, capture, selectedCells)

to click those cells

Relay mode

Call

solveCaptcha({ useTunnel: false })

(Tailscale) or

solveCaptcha()

(tunnel)

Send
```
result.relayUrl
```
to human via
```
message
```
tool
Wait — resolves when human completes the CAPTCHA
Token is auto-injected; continue automation

Requirements

Chrome/Chromium with
```
--remote-debugging-port=18800
```
Node.js 18+ and
```
npm install
```
(deps: ws, sharp)
Relay mode only: Tailscale or internet for tunnel