Cómo resolver CAPTCHAs en OpenClaw: Guía paso a paso con la extensión CapSolver

Introducción

Cuando tu asistente de IA navega por la web por ti, los CAPTCHAs son el principal obstáculo. Las páginas protegidas bloquean al agente, los formularios no se pueden enviar y las tareas se detienen esperando intervención humana.

OpenClaw es un asistente de IA personal que puede navegar por la web, completar formularios, hacer clic en botones y extraer datos, todo a través de lenguaje natural. Pero como cualquier automatización de navegadores, se queda atascado en los CAPTCHAs.

CapSolver lo cambia por completo. Al cargar la extensión de CapSolver en el navegador de OpenClaw, los CAPTCHAs se resuelven automáticamente e invisiblemente en segundo plano. Sin código. Sin llamadas a API desde tu parte. Sin cambios en la forma en que hablas a tu asistente de IA.

Lo mejor de todo es que ni siquiera necesitas mencionar los CAPTCHAs al IA. Solo le dices que espere un momento antes de enviar — y cuando haga clic en Enviar, el CAPTCHA ya está resuelto.

¿Qué es OpenClaw?

OpenClaw es un asistente de IA personal que ejecutas en tus propios dispositivos. Responde en los canales que ya usas — WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Google Chat, Microsoft Teams, y más.

Características clave

• Bandeja de múltiples canales: Habla con tu IA desde WhatsApp, Discord, Telegram, Slack, etc.
• Navegador integrado: El agente puede abrir pestañas, navegar por páginas, hacer clic en botones, completar formularios y tomar capturas de pantalla
• Enfoque en local: Funciona en tu hardware — tus datos permanecen contigo
• Sistema de complementos: Extiende con extensiones y integraciones personalizadas
• Soporte de voz: Habla con tu agente en macOS, iOS y Android

La herramienta del navegador

OpenClaw ejecuta un perfil de Chromium dedicado que solo el agente controla. Está completamente aislado de tu navegador personal. El agente puede:

• Abrir y navegar a cualquier URL
• Leer el contenido de la página y tomar instantáneas
• Hacer clic en botones, completar formularios, seleccionar menús desplegables
• Tomar capturas de pantalla y generar PDFs
• Gestionar múltiples pestañas

Imagínalo como darle a tu asistente de IA su propia ventana de navegador.

¿Qué es CapSolver?

CapSolver es un servicio líder de resolución de CAPTCHAs que proporciona soluciones impulsadas por IA para evitar diversos desafíos de CAPTCHA. Con soporte para múltiples tipos de CAPTCHA y tiempos de respuesta rápidos, CapSolver se integra sin problemas en flujos de trabajo automatizados.

Tipos de CAPTCHA soportados

• reCAPTCHA v2 (basado en imágenes e invisible)
• reCAPTCHA v3 & v3 Enterprise
• Cloudflare Turnstile
• Cloudflare 5-second Challenge
• AWS WAF CAPTCHA
• Otros mecanismos de CAPTCHA y anti-bot ampliamente utilizados

¿Por qué esta integración es diferente?

La mayoría de las integraciones de resolución de CAPTCHA requieren que escribas código — crear llamadas a API, consultar resultados, inyectar tokens en campos de formulario ocultos. Así funciona con herramientas como Crawlee, Puppeteer o Playwright.

OpenClaw + CapSolver es fundamentalmente diferente:

La clave del insight: La extensión de CapSolver se ejecuta dentro de la sesión del navegador del agente. Cuando el agente navega a una página con un CAPTCHA, la extensión lo detecta, lo resuelve en segundo plano y inyecta el token — todo antes de que el agente intente enviar el formulario.

Solo necesitas darle tiempo. En lugar de decirle a la IA "resuelve el CAPTCHA", simplemente dices:

"Ve a esa página, espera 60 segundos, luego haz clic en Enviar."

Eso es todo. La IA no necesita saber nada sobre CapSolver en absoluto.

Requisitos previos

Antes de configurar la integración, asegúrate de tener:

1. OpenClaw instalado y el gateway en ejecución
2. Una cuenta de CapSolver con clave de API (regístrate aquí)
3. Chromium o Chrome para pruebas (ver nota importante a continuación)

Importante: Necesitas Chromium, no Google Chrome

Google Chrome 137+ (lanzado a mediados de 2025) eliminó en silencio el soporte para --load-extension en las versiones etiquetadas. Esto significa que las extensiones de Chrome no se pueden cargar en sesiones automatizadas usando Google Chrome estándar. No hay error — la bandera simplemente se ignora.

Esto afecta a Google Chrome y Microsoft Edge. Debes usar una de estas alternativas:

Cómo instalar Chrome para pruebas:

# Opción 1: A través de Playwright (recomendado)
npx playwright install chromium

# El binario estará en una ruta como:
# ~/.cache/ms-playwright/chromium-XXXX/chrome-linux64/chrome  (Linux)
# ~/Library/Caches/ms-playwright/chromium-XXXX/chrome-mac/Chromium.app/Contents/MacOS/Chromium  (macOS)

# Opción 2: Descarga directa de Chrome para pruebas
# Visita: https://googlechromelabs.github.io/chrome-for-testing/
# Descarga la versión que coincida con tu sistema operativo

Después de la instalación, anota la ruta completa al binario — la necesitarás para la configuración.

Configuración paso a paso

Paso 1: Descargar la extensión de CapSolver Chrome

Descarga la extensión de CapSolver Chrome y extraela a ~/.openclaw/capsolver-extension/:

1. Ve a las versiones de la extensión de CapSolver en GitHub
2. Descarga la última CapSolver.Browser.Extension-chrome-vX.X.X.zip
3. Extrae el zip:

mkdir -p ~/.openclaw/capsolver-extension
unzip CapSolver.Browser.Extension-chrome-v*.zip -d ~/.openclaw/capsolver-extension/

4. Verifica que la extracción funcionó:

ls ~/.openclaw/capsolver-extension/manifest.json

Deberías ver manifest.json — esto confirma que la extensión está en el lugar correcto.

Paso 2: Establecer tu clave de API de CapSolver

Abre el archivo de configuración de la extensión en ~/.openclaw/capsolver-extension/assets/config.js y reemplaza el valor de apiKey con el tuyo:

export const defaultConfig = {
  apiKey: 'CAP-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',  // ← tu clave aquí
  useCapsolver: true,
  // ... resto de la configuración
};

Puedes obtener tu clave de API desde tu panel de CapSolver.

Paso 3: Configurar el navegador

Edita el archivo de configuración de OpenClaw en ~/.openclaw/openclaw.json para habilitar el navegador y cargar la extensión:

{
  "browser": {
    "enabled": true,
    "executablePath": "/ruta/a/chrome-para-pruebas/chrome",
    "extensions": [
      "~/.openclaw/capsolver-extension"
    ],
    "noSandbox": true,
    "defaultProfile": "openclaw"
  }
}

Reemplaza /ruta/a/chrome-para-pruebas/chrome con la ruta real a tu binario de Chrome para pruebas o Chromium. Por ejemplo:

• Linux (Playwright): ~/.cache/ms-playwright/chromium-1200/chrome-linux64/chrome
• macOS (Playwright): ~/Library/Caches/ms-playwright/chromium-1200/chrome-mac/Chromium.app/Contents/MacOS/Chromium

Nota: noSandbox: true es necesario en la mayoría de los entornos de servidor, contenedores Docker y sistemas CI donde no se puede inicializar el sandbox de Chrome. En sistemas de escritorio con sandboxing adecuado, puedes omitir esto.

Paso 4: Reiniciar el gateway

# Si usas PM2:
pm2 restart opencrawl --update-env

# Si lo ejecutas directamente:
openclaw gateway restart

Paso 5: Verificar la configuración

Revisa los registros del gateway para confirmar que todo se cargó correctamente:

pm2 logs opencrawl --lines 20 --nostream

Deberías ver estas líneas clave:

[browser/chrome] Cargando 1 extensión(es)
[browser/chrome] Iniciando Chrome: /ruta/a/chrome-para-pruebas (args: 15)

Comprobación avanzada — verifica que la extensión esté activa a través del Protocolo de herramientas de desarrollo de Chrome:

curl -s http://127.0.0.1:8091/json/list

Busca una entrada service_worker con chrome-extension:// en la URL:

{
  "title": "Service Worker chrome-extension://cnopfoopenkdblckmekkipihdnambjhf/background.js",
  "type": "service_worker",
  "url": "chrome-extension://cnopfoopenkdblckmekkipihdnambjhf/background.js"
}

Si ves esto, CapSolver está cargado y en ejecución.

Cómo usarlo

Esta es la sección más importante. Una vez que la configuración esté completa, usar CapSolver con OpenClaw es muy sencillo.

La regla dorada

No menciones CAPTCHAs o CapSolver al IA. Solo dale tiempo antes de enviar formularios.

El agente de IA no necesita saber sobre los CAPTCHAs. La extensión se encarga de todo en segundo plano. Todo lo que necesitas hacer es incluir un tiempo de espera en tus instrucciones para que la extensión tenga tiempo de resolver el desafío antes de que se envíe el formulario.

Ejemplo 1:

Envía esto a tu agente de OpenClaw (por Discord, WhatsApp, Telegram u cualquier canal):

Ve a https://example.com, espera 60 segundos,
luego haz clic en Enviar y dime qué texto aparece en la página.

¿Qué ocurre detrás de escena:

1. El agente navega a la página de demostración de reCAPTCHA
2. El script de contenido de CapSolver detecta el widget de reCAPTCHA
3. La extensión llama a la API de CapSolver y resuelve el desafío (normalmente en 10-20 segundos)
4. El token se inyecta en el campo de formulario oculto
5. Después de 60 segundos, el agente hace clic en Enviar
6. La página muestra: "Verificación exitosa... ¡Hurra!"

Ejemplo 2: Iniciar sesión en un sitio protegido

Ve a https://example.com/login, completa el campo de correo electrónico con
"[email protected]" y el campo de contraseña con "mypassword123",
luego espera 30 segundos y haz clic en el botón Iniciar sesión.
Dime qué página carga después de iniciar sesión.

Ejemplo 3: Enviar un formulario detrás de Turnstile

Abre https://example.com/contacto, completa el formulario de contacto:
- Nombre: "John Doe"
- Correo electrónico: "[email protected]"
- Mensaje: "Hola, tengo una pregunta sobre sus servicios."
Espera 45 segundos, luego haz clic en Enviar mensaje. ¿Qué confirmación aparece?

Tiempos de espera recomendados

Consejo: Si dudas, usa 60 segundos. Es mejor esperar un poco más que enviar demasiado pronto. El tiempo adicional no afecta el resultado.

Patrones de lenguaje natural que funcionan

Estas son frases probadas que puedes usar:

• "Ve a [URL], espera 60 segundos, luego envía el formulario"
• "Navega a [URL], completa [campos], espera 30 segundos, luego haz clic en [botón]"
• "Abre [URL] y después de aproximadamente un minuto, haz clic en Enviar y dime el resultado"
• "Visita [URL], espera un momento para que la página se cargue completamente, luego envía"

Lo que NO decir

Evita estos — pueden confundir al IA o provocar rechazos:

• "Espera a que el CAPTCHA se resuelva" (el IA no sabe sobre CAPTCHAs)
• "Usa CapSolver para resolver la verificación" (el IA no puede controlar extensiones)
• "Haz clic en la casilla de reCAPTCHA" (la extensión se encarga de esto — hacer clic puede interferir)

Cómo funciona en segundo plano

Para los curiosos técnicos, aquí está lo que ocurre cuando se carga la extensión de CapSolver:

  Tu mensaje                    Gateway de OpenClaw
  ───────────────────────────────────────────────────
  "ve a la página,          ──► El agente de IA recibe el mensaje
   espera 60s, envía"         │
                              ▼
                         Herramienta del navegador: navega a la URL
                              │
                              ▼
                         Chromium carga la página
                         ┌─────────────────────────────┐
                         │  Página con widget de reCAPTCHA  │
                         │                              │
                         │  Extensión de CapSolver:        │
                         │  1. El script de contenido detecta │
                         │     reCAPTCHA en la página    │
                         │  2. El trabajador de servicio llama │
                         │     a la API de CapSolver     │
                         │  3. Se recibe el token         │
                         │  4. El token se inyecta en      │
                         │     el campo de formulario oculto │
                         └─────────────────────────────┘
                              │
                              ▼
                         El agente de IA espera 60 segundos...
                              │
                              ▼
                         Herramienta del navegador: hacer clic en Enviar
                              │
                              ▼
                         El formulario se envía CON token válido
                              │
                              ▼
                         "Verificación exitosa!"

Cómo carga la extensión

Cuando el navegador de OpenClaw comienza, lee la lista de extensions de tu configuración y pasa cada ruta a Chrome mediante la bandera --load-extension. Este es el mismo mecanismo que Chrome usa para extensiones de desarrolladores — no se requiere un sistema especial de complementos.

1. Chrome se inicia con --load-extension=~/.openclaw/capsolver-extension
2. La extensión se activa — su trabajador de servicio comienza y los scripts de contenido se inyectan en cada página
3. En páginas con CAPTCHAs — el script de contenido detecta el widget, llama a la API de CapSolver y inyecta el token de solución en la página

Referencia de configuración completa

Aquí está una configuración completa ~/.openclaw/openclaw.json con la extensión CapSolver:

{
  "browser": {
    "enabled": true,
    "executablePath": "/ruta/a/chrome-para-pruebas/chrome",
    "extensions": [
      "~/.openclaw/capsolver-extension"
    ],
    "noSandbox": true,
    "defaultProfile": "openclaw"
  }
}

"navegador": {
"habilitado": true,
"rutaEjecutable": "/ruta/a/chrome-para-pruebas/chrome",
"extensiones": [
"~/.openclaw/capsolver-extensión"
],
"noSandbox": true,
"perfilPredeterminado": "openclaw"
}
}

### Opciones de configuración

| Opción | Descripción |
|--------|-------------|
| `navegador.rutaEjecutable` | Ruta al binario de Chrome para pruebas o Chromium (requerido) |
| `navegador.extensiones` | Matriz de rutas de directorios de extensiones para cargar en Chrome |
| `navegador.noSandbox` | Establecer en `true` en servidores/Docker (el sandbox de Chrome requiere capacidades especiales del kernel) |
| `navegador.perfilPredeterminado` | Nombre del perfil del navegador (predeterminado: `"chrome"`) |

La clave de la API de CapSolver se configura directamente en el archivo `assets/config.js` de la extensión (ver Paso 2 anterior).

---

## Solución de problemas

### Extensión no cargando

**Síntoma**: Los registros del gateway muestran `Cargando 1 extensión(es)` pero no aparecen objetivos `chrome-extension://` en CDP.

**Causa**: Estás usando Chrome de Google 137+ que ignora silenciosamente `--load-extension`.

**Solución**: Cambia a Chrome para pruebas o Chromium. Actualiza `navegador.rutaEjecutable` en tu configuración para que apunte al binario correcto.

**Verifica tu versión de Chrome**:
```bash
/ruta/a/tu/chrome --version
# Chrome para pruebas: "Chromium 143.0.7499.4"
# Chrome de marca: "Google Chrome 143.0.7499.109"

CAPTCHA no resuelto (Formulario falla)

Causas posibles:

1. Tiempo de espera insuficiente — Aumenta a 60 segundos
2. Clave de API inválida — Verifica tu dashboard de CapSolver
3. Saldo insuficiente — Recarga tu cuenta de CapSolver
4. Extensión no cargada — Ver "Extensión no cargando" anterior

Tiempo de espera del navegador en la primera acción

Síntoma: La primera acción del navegador después de reiniciar el gateway se bloquea, pero las acciones posteriores funcionan.

Causa: Inicio frío de Chromium + reintentos de conexión CDP de Playwright pueden exceder el tiempo de espera de 20 segundos en el primer intento.

Solución: Es un problema conocido. Simplemente reintenta el comando — el segundo intento tendrá éxito ya que el navegador estará caliente.

Chrome se cierra después de cambiar de navegadores

Síntoma: Después de cambiar de Chrome de marca a Chrome para pruebas, el navegador se cierra con errores de caché en disco.

Causa: El directorio de datos de usuario fue creado por una versión diferente de Chrome e es incompatible.

Solución: Elimina el antiguo perfil del navegador y reinicia:

rm -rf ~/.openclaw/navegador/openclaw/datos-de-usuario
# Luego reinicia el gateway

Buenas prácticas

1. Siempre usar tiempos de espera generosos

Más tiempo de espera siempre es más seguro. El CAPTCHA normalmente se resuelve en 5-20 segundos, pero la latencia de red, desafíos complejos o reintentos pueden agregar tiempo. 30-60 segundos es el punto óptimo.

2. Mantén tus mensajes naturales

En lugar de:

"Navega a la URL, espera a que se resuelva el captcha, luego envía"

Usa:

"Ve a la URL, espera unos minutos, luego envía el formulario"

Un lenguaje natural funciona mejor con la IA y evita activar rechazos de seguridad.

3. Monitorea tu saldo de CapSolver

Cada resolución de CAPTCHA cuesta créditos. Verifica tu saldo en capsolver.com/dashboard regularmente para evitar interrupciones.

4. Usa noSandbox en servidores

Al ejecutar OpenClaw en un servidor remoto, contenedor Docker o entorno CI, siempre establece noSandbox: true en tu configuración de navegador. El sandbox de Chrome requiere capacidades especiales del kernel que no están disponibles en la mayoría de los entornos de servidor.

5. Establece DISPLAY para servidores sin interfaz gráfica

Las extensiones de Chrome requieren una pantalla, incluso en servidores sin interfaz gráfica. Usa Xvfb para crear una pantalla virtual:

# Instala Xvfb
sudo apt-get install xvfb

# Inicia una pantalla virtual
Xvfb :99 -screen 0 1280x720x24 &

# Establece DISPLAY para OpenClaw
export DISPLAY=:99

Conclusión

La integración de OpenClaw + CapSolver representa un enfoque fundamentalmente nuevo para resolver CAPTCHAS. En lugar de escribir código para detectar CAPTCHAS, llamar APIs y inyectar tokens, simplemente:

1. Descarga la extensión y agrégala a tu configuración
2. Puntera a Chromium (no Chrome de marca)
3. Habla con tu IA de forma natural — simplemente incluye un tiempo de espera antes de enviar formularios

La extensión de Chrome de CapSolver maneja el resto — detecta CAPTCHAS, los resuelve mediante la API de CapSolver y inyecta tokens en la página. Tu asistente de IA nunca necesita saber nada sobre CAPTCHAS en absoluto.

Este es el aspecto de la resolución de CAPTCHAS cuando tienes un asistente de IA: invisible, automática y sin código.

¿Listo para comenzar? Regístrate en CapSolver y usa el código de bonificación OPENCLAW para obtener un 6% adicional en tu primer recarga!

Preguntas frecuentes

¿Necesito decirle a la IA sobre CapSolver?

No. De hecho, debes evitar mencionar CAPTCHAS o CapSolver en tus mensajes. La extensión funciona de forma invisible en segundo plano. Simplemente incluye un tiempo de espera en tus instrucciones (por ejemplo, "espera 60 segundos, luego envía") para darle tiempo a la extensión de resolver cualquier CAPTCHA en la página.

¿Por qué no puedo usar Chrome de Google regular?

Chrome 137+ (lanzado a mediados de 2025) eliminó el soporte para la bandera de línea de comandos --load-extension en las versiones de marca. Esto significa que las extensiones de Chrome no se pueden cargar en sesiones automatizadas. Necesitas Chrome para pruebas o Chromium independiente, que aún admiten esta bandera.

¿Qué tipos de CAPTCHA soporta CapSolver?

CapSolver soporta reCAPTCHA v2 (casilla e invisible), reCAPTCHA v3, Cloudflare Turnstile, AWS WAF CAPTCHA y más. La extensión de Chrome detecta automáticamente el tipo de CAPTCHA y lo resuelve en consecuencia.

¿Cuánto cuesta CapSolver?

CapSolver ofrece precios competitivos basados en el tipo de CAPTCHA y el volumen. Visita capsolver.com para ver los precios actuales.

¿Es gratis OpenClaw?

OpenClaw es de código abierto y gratuito para ejecutar en tu propio hardware. Necesitarás claves de API para el proveedor de modelos de IA de tu elección y, para resolver CAPTCHAS, una cuenta de CapSolver con créditos.

¿Cuánto tiempo debo decirle a la IA que espere?

Para la mayoría de los CAPTCHAS, 30-60 segundos es suficiente. El tiempo real de resolución suele ser de 5-20 segundos, pero agregar un margen adicional garantiza la confiabilidad. Si dudas, usa 60 segundos.

¿Puedo usar esto en un servidor sin interfaz gráfica?

Sí. Necesitarás Xvfb (X Virtual Framebuffer) para la pantalla ya que las extensiones de Chrome requieren un contexto de pantalla. Establece DISPLAY=:99 y ejecuta Xvfb :99 en segundo plano. También establece noSandbox: true en tu configuración de navegador.