Como resolver CAPTCHAs no OpenClaw: Guia Passo a Passo com a Extensão CapSolver

Introdução

Quando seu assistente de IA navega pela web para você, os CAPTCHAs são o maior obstáculo. Páginas protegidas bloqueiam o agente, formulários não podem ser enviados e tarefas ficam paralisadas esperando intervenção humana.

OpenClaw é um assistente de IA pessoal que pode navegar pela web, preencher formulários, clicar em botões e extrair dados — tudo através de linguagem natural. Mas, como qualquer automação de navegador, ele fica travado nos CAPTCHAs.

CapSolver muda isso completamente. Carregando a extensão CapSolver no navegador do OpenClaw, os CAPTCHAs são resolvidos automaticamente e invisivelmente no fundo. Nenhum código. Nenhuma chamada de API do seu lado. Nenhuma alteração no modo como você fala com o seu assistente de IA.

A melhor parte? Você nem precisa mencionar CAPTCHAs para a IA. Basta dizer que ela espere um momento antes de enviar — e quando ela clicar em Enviar, o CAPTCHA já estará resolvido.

O que é OpenClaw?

OpenClaw é um assistente de IA pessoal que você executa em seus próprios dispositivos. Ele responde você nos canais que você já usa — WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Google Chat, Microsoft Teams e mais.

Principais Funcionalidades

• Caixa de entrada multi-canal: converse com sua IA por WhatsApp, Discord, Telegram, Slack e mais
• Navegador integrado: o agente pode abrir guias, navegar por páginas, clicar em botões, preencher formulários e fazer capturas de tela
• Primeiro local: roda em seu próprio hardware — seus dados ficam com você
• Sistema de plugins: estenda com extensões e integrações personalizadas
• Suporte a voz: fale com seu agente no macOS, iOS e Android

A Ferramenta do Navegador

O OpenClaw executa um perfil dedicado do Chromium que só o agente de IA controla. Ele está completamente isolado do seu navegador pessoal. O agente pode:

• Abrir e navegar até qualquer URL
• Ler o conteúdo da página e fazer capturas
• Clicar em botões, preencher formulários, selecionar listas suspensas
• Fazer capturas de tela e gerar PDFs
• Gerenciar várias guias

Pense nisso como dar a seu assistente de IA uma janela de navegador própria.

O que é CapSolver?

CapSolver é um serviço líder de resolução de CAPTCHA que fornece soluções baseadas em IA para contornar vários desafios de CAPTCHA. Com suporte para vários tipos de CAPTCHA e tempos de resposta rápidos, o CapSolver se integra sem problemas a fluxos de trabalho automatizados.

Tipos de CAPTCHA Suportados

• reCAPTCHA v2 (baseado em imagem e invisível)
• reCAPTCHA v3 & v3 Enterprise
• Cloudflare Turnstile
• Cloudflare 5-second Challenge
• AWS WAF CAPTCHA
• Outros mecanismos de anti-bot e CAPTCHA amplamente usados

Por que Essa Integração é Diferente

A maioria das integrações de resolução de CAPTCHA exige que você escreva código — crie chamadas de API, faça polling por resultados, injete tokens em campos ocultos de formulários. É assim que funciona com ferramentas como Crawlee, Puppeteer ou Playwright.

OpenClaw + CapSolver é fundamentalmente diferente:

A principal descoberta: a extensão CapSolver roda na sessão do navegador do agente. Quando o agente navega para uma página com um CAPTCHA, a extensão o detecta, o resolve em segundo plano e injeta o token — tudo antes que o agente mesmo tente enviar o formulário.

Você só precisa dar tempo. Em vez de dizer à IA "resolva o CAPTCHA", você simplesmente diz:

"Vá para essa página, espere 60 segundos, depois clique em Enviar."

Isso é tudo. A IA não precisa saber nada sobre o CapSolver.

Requisitos Prévios

Antes de configurar a integração, certifique-se de que você tem:

1. OpenClaw instalado e o gateway em execução
2. Uma conta CapSolver com chave de API (inscreva-se aqui)
3. Chromium ou Chrome para Testes (veja a nota importante abaixo)

Importante: Você Precisa do Chromium, Não do Google Chrome

Google Chrome 137+ (lançado no meio de 2025) removeu silenciosamente o suporte para --load-extension nos builds com marca. Isso significa que extensões do Chrome não podem ser carregadas em sessões automatizadas usando o Google Chrome padrão. Não há erro — o sinalizador é simplesmente ignorado.

Isso afeta o Google Chrome e o Microsoft Edge. Você deve usar uma das alternativas abaixo:

Como instalar o Chrome para Testes:

# Opção 1: Via Playwright (recomendado)
npx playwright install chromium

# O binário estará em um caminho como:
# ~/.cache/ms-playwright/chromium-XXXX/chrome-linux64/chrome  (Linux)
# ~/Library/Caches/ms-playwright/chromium-XXXX/chrome-mac/Chromium.app/Contents/MacOS/Chromium  (macOS)

# Opção 2: Via download direto do Chrome para Testes
# Visite: https://googlechromelabs.github.io/chrome-for-testing/
# Baixe a versão correspondente ao seu sistema operacional

Após a instalação, anote o caminho completo para o binário — você precisará dele para a configuração.

Configuração Passo a Passo

Passo 1: Baixe a Extensão CapSolver para Chrome

Baixe a extensão CapSolver para Chrome e extraia-a para ~/.openclaw/capsolver-extension/:

1. Acesse as versões da extensão CapSolver no GitHub
2. Baixe a versão mais recente CapSolver.Browser.Extension-chrome-vX.X.X.zip
3. Extraia o zip:

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

4. Verifique se a extração funcionou:

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

Você deve ver manifest.json — isso confirma que a extensão está no lugar certo.

Passo 2: Defina sua Chave de API do CapSolver

Abra o arquivo de configuração da extensão em ~/.openclaw/capsolver-extension/assets/config.js e substitua o valor apiKey pela sua própria:

export const defaultConfig = {
  apiKey: 'CAP-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',  // ← sua chave aqui
  useCapsolver: true,
  // ... restante da configuração
};

Você pode obter sua chave de API em seu painel do CapSolver.

Passo 3: Configure o Navegador

Edite o arquivo de configuração do OpenClaw em ~/.openclaw/openclaw.json para habilitar o navegador e carregar a extensão:

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

Substitua /caminho/para/chrome-para-testes/chrome pelo caminho real para seu binário do Chrome para Testes ou Chromium. Por exemplo:

• 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 é necessário na maioria dos ambientes de servidor, contêineres Docker e sistemas CI onde o sandbox do Chrome não pode ser inicializado. Em sistemas de desktop com sandboxing adequado, você pode omitir isso.

Passo 4: Reinicie o Gateway

# Se usando PM2:
pm2 restart opencrawl --update-env

# Se executando diretamente:
openclaw gateway restart

Passo 5: Verifique a Configuração

Verifique os logs do gateway para confirmar que tudo carregou corretamente:

pm2 logs opencrawl --lines 20 --nostream

Você deve ver essas linhas-chave:

[browser/chrome] Carregando 1 extensão(s)
[browser/chrome] Iniciando Chrome: /caminho/para/chrome-para-testes (args: 15)

Verificação avançada — verifique se a extensão está ativa via Protocolo de Ferramentas de Desenvolvedor do Chrome:

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

Procure uma entrada service_worker com chrome-extension:// na URL:

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

Se você ver isso, o CapSolver está carregado e em execução.

Como Usar

Esta é a seção mais importante. Após a configuração estar completa, usar o CapSolver com o OpenClaw é extremamente simples.

A Regra Dourada

Não mencione CAPTCHAs ou CapSolver para a IA. Apenas dê tempo antes de enviar formulários.

O agente de IA não precisa saber sobre CAPTCHAs. A extensão cuida de tudo no fundo. Tudo o que você precisa fazer é incluir um tempo de espera nas suas instruções para que a extensão tenha tempo de resolver o desafio antes que o formulário seja enviado.

Exemplo 1:

Envie isso para seu agente do OpenClaw (por Discord, WhatsApp, Telegram ou qualquer canal):

Vá para https://exemplo.com, espere 60 segundos,
depois clique em Enviar e me diga qual texto aparece na página.

O que acontece em segundo plano:

1. O agente navega para a página de demonstração do reCAPTCHA
2. O script de conteúdo do CapSolver detecta o widget reCAPTCHA
3. A extensão chama a API do CapSolver e resolve o desafio (geralmente em 10-20 segundos)
4. O token é injetado no campo oculto do formulário
5. Após 60 segundos, o agente clica em Enviar
6. A página mostra: "Verificação bem-sucedida... Hooray!"

Exemplo 2: Faça login em um site protegido

Vá para https://exemplo.com/login, preencha o campo de e-mail com
"[email protected]" e o campo de senha com "mypassword123",
depois espere 30 segundos e clique no botão Entrar.
Me diga qual página carrega após fazer login.

Exemplo 3: Envie um formulário atrás do Turnstile

Abra https://exemplo.com/contato, preencha o formulário de contato:
- Nome: "John Doe"
- E-mail: "[email protected]"
- Mensagem: "Olá, tenho uma pergunta sobre seus serviços."
Espere 45 segundos, depois clique em Enviar Mensagem. Qual confirmação aparece?

Tempos de Espera Recomendados

Dica: Quando em dúvida, use 60 segundos. É melhor esperar um pouco mais do que enviar cedo demais. O tempo extra não afeta o resultado.

Padrões de Linguagem Natural que Funcionam

Aqui estão frasings comprovados que você pode usar:

• "Vá para [URL], espere 60 segundos, depois envie o formulário"
• "Navegue até [URL], preencha [campos], espere 30 segundos, depois clique em [botão]"
• "Abra [URL] e após cerca de um minuto, clique em Enviar e me diga o resultado"
• "Visite [URL], espere um momento para a página carregar completamente, depois envie"

O que NÃO Dizer

Evite esses — eles podem confundir a IA ou acionar recusas:

• "Espere até que o CAPTCHA seja resolvido" (a IA não sabe sobre CAPTCHAs)
• "Use o CapSolver para resolver a verificação" (a IA não pode controlar extensões)
• "Clique na caixa de reCAPTCHA" (a extensão cuida disso — clicar pode interferir)

Como Funciona por Baixo dos Panos

Para os curiosos técnicos, aqui está o que acontece quando a extensão CapSolver é carregada:

  Sua mensagem                    Gateway do OpenClaw
  ───────────────────────────────────────────────────
  "vá para a página,          ──►  Agente de IA recebe a mensagem
   espere 60s, enviar"         │
                              ▼
                         Ferramenta de Navegador: navega até a URL
                              │
                              ▼
                         Chromium carrega a página
                         ┌─────────────────────────────┐
                         │  Página com widget reCAPTCHA │
                         │                              │
                         │  Extensão CapSolver:        │
                         │  1. Script de conteúdo detecta │
                         │     reCAPTCHA na página      │
                         │  2. Worker de serviço chama   │
                         │     API do CapSolver         │
                         │  3. Token recebido           │
                         │  4. Token injetado no campo  │
                         │     oculto do formulário     │
                         └─────────────────────────────┘
                              │
                              ▼
                         Agente de IA espera 60 segundos...
                              │
                              ▼
                         Ferramenta de Navegador: clica em Enviar
                              │
                              ▼
                         Formulário é enviado COM token válido
                              │
                              ▼
                         "Verificação bem-sucedida!"

Como a Extensão é Carregada

Quando o navegador do OpenClaw inicia, ele lê a lista de extensions da sua configuração e passa cada caminho para o Chrome via o sinalizador --load-extension. É o mesmo mecanismo que o Chrome usa para extensões de desenvolvedor — nenhuma sistema de plugin especial é necessário.

1. O Chrome inicia com --load-extension=~/.openclaw/capsolver-extension
2. A extensão é ativada — seu worker de serviço começa e scripts de conteúdo são injetados em todas as páginas
3. Em páginas com CAPTCHAs — o script de conteúdo detecta o widget, chama a API do CapSolver e injeta o token de solução na página

Referência de Configuração Completa

Aqui está uma configuração completa ~/.openclaw/openclaw.json com a extensão CapSolver:

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

"browser": {
"enabled": true,
"executablePath": "/caminho/para/chrome-for-testing/chrome",
"extensions": [
"~/.openclaw/capsolver-extension"
],
"noSandbox": true,
"defaultProfile": "openclaw"
}
}

### Opções de Configuração

| Opção | Descrição |
|--------|-------------|
| `browser.executablePath` | Caminho para o binário Chrome for Testing ou Chromium (necessário) |
| `browser.extensions` | Matriz de caminhos de diretórios de extensão para carregar no Chrome |
| `browser.noSandbox` | Defina como `true` em servidores/Docker (o sandbox do Chrome requer capacidades especiais do kernel) |
| `browser.defaultProfile` | Nome do perfil do navegador (padrão: `"chrome"`) |

A chave da API do CapSolver é configurada diretamente no arquivo `assets/config.js` da extensão (veja o Passo 2 acima).

---

## Solução de Problemas

### Extensão Não Carregando

**Sintoma**: Os logs do Gateway mostram `Loading 1 extension(s)` mas nenhum `chrome-extension://` aparece nos CDP.

**Causa**: Você está usando o Chrome da Google 137+ que silenciosamente ignora `--load-extension`.

**Solução**: Mude para Chrome for Testing ou Chromium. Atualize `browser.executablePath` na sua configuração para apontar para o binário correto.

**Verifique sua versão do Chrome**:
```bash
/caminho/para/seu/chrome --version
# Chrome for Testing: "Chromium 143.0.7499.4"
# Chrome da Google: "Google Chrome 143.0.7499.109"

CAPTCHA Não Resolvido (Formulário Falha)

Causas possíveis:

1. Tempo de espera insuficiente — Aumente para 60 segundos
2. Chave de API inválida — Verifique seu painel do CapSolver
3. Saldo insuficiente — Recarregue sua conta do CapSolver
4. Extensão não carregada — Veja "Extensão Não Carregando" acima

Tempo de Espera do Navegador na Primeira Ação

Sintoma: A primeira ação do navegador após reiniciar o gateway falha com timeout, mas as ações subsequentes funcionam.

Causa: Inicialização fria do Chromium + tentativas de conexão CDP do Playwright podem exceder o timeout de 20 segundos na primeira tentativa.

Solução: Este é um problema conhecido. Simplesmente tente novamente o comando — a segunda tentativa terá sucesso, pois o navegador já estará aquecido.

Chrome Trava Após Trocar Navegadores

Sintoma: Após mudar do Chrome da Google para o Chrome for Testing, o navegador trava com erros de cache do disco.

Causa: O diretório de dados do usuário foi criado por uma versão diferente do Chrome e é incompatível.

Solução: Exclua o antigo perfil do navegador e reinicie:

rm -rf ~/.openclaw/browser/openclaw/user-data
# Em seguida, reinicie o gateway

Boas Práticas

1. Sempre Use Tempos de Espera Generosos

Mais tempo de espera é sempre mais seguro. O CAPTCHA geralmente é resolvido em 5-20 segundos, mas a latência da rede, desafios complexos ou tentativas podem adicionar tempo. 30-60 segundos é o ponto ideal.

2. Mantenha suas Mensagens Naturais

Em vez de:

"Navegue até a URL, espere pelo solucionador de CAPTCHA, depois envie"

Use:

"Vá até a URL, espere cerca de um minuto, depois envie o formulário"

Frasas naturais funcionam melhor com a IA e evitam rejeições de segurança.

3. Monitore seu Saldo do CapSolver

Cada resolução de CAPTCHA custa créditos. Verifique seu saldo em capsolver.com/dashboard regularmente para evitar interrupções.

4. Use noSandbox em Servidores

Ao executar o OpenClaw em um servidor remoto, container Docker ou ambiente CI, sempre defina noSandbox: true na sua configuração do navegador. O sandbox do Chrome requer capacidades especiais do kernel que não estão disponíveis na maioria dos ambientes de servidor.

5. Defina DISPLAY para Servidores Sem Tela

Extensões do Chrome exigem uma tela, mesmo em servidores sem tela. Use o Xvfb para criar uma tela virtual:

# Instale o Xvfb
sudo apt-get install xvfb

# Inicie uma tela virtual
Xvfb :99 -screen 0 1280x720x24 &

# Defina DISPLAY para o OpenClaw
export DISPLAY=:99

Conclusão

A integração OpenClaw + CapSolver representa uma abordagem fundamentalmente nova para a resolução de CAPTCHA. Em vez de escrever código para detectar CAPTCHAs, chamar APIs e injetar tokens, você simplesmente:

1. Baixe a extensão e adicione-a à sua configuração
2. Aponte para o Chromium (não o Chrome da Google)
3. Converse com sua IA naturalmente — apenas inclua um tempo de espera antes das submissões do formulário

A extensão do Chrome do CapSolver cuida de tudo o resto — detectando CAPTCHAs, resolvendo-os via API do CapSolver e injetando tokens na página. Seu assistente de IA nunca precisa saber sobre CAPTCHAs de forma alguma.

Essa é a aparência da resolução de CAPTCHA quando você tem um assistente de IA: invisível, automática e sem código.

Pronto para começar? Registre-se no CapSolver e use o código promocional OPENCLAW para obter um bônus adicional de 6% na sua primeira recarga!

Perguntas Frequentes

Preciso informar a IA sobre o CapSolver?

Não. Na verdade, você deve evitar mencionar CAPTCHAs ou CapSolver em suas mensagens. A extensão funciona invisivelmente em segundo plano. Apenas inclua um tempo de espera em suas instruções (ex.: "espere 60 segundos, depois envie") para dar à extensão tempo para resolver quaisquer CAPTCHAs na página.

Por que não posso usar o Chrome da Google normal?

O Chrome 137+ (lançado no meio de 2025) removeu o suporte ao sinalizador de linha de comando --load-extension nas versões comerciais. Isso significa que extensões do Chrome não podem ser carregadas em sessões automatizadas. Você precisa do Chrome for Testing ou do Chromium standalone, que ainda suportam esse sinalizador.

Quais tipos de CAPTCHA o CapSolver suporta?

O CapSolver suporta reCAPTCHA v2 (checkbox e invisível), reCAPTCHA v3, Cloudflare Turnstile, AWS WAF CAPTCHA e muito mais. A extensão do Chrome detecta automaticamente o tipo de CAPTCHA e o resolve de acordo.

Quanto custa o CapSolver?

O CapSolver oferece preços competitivos com base no tipo de CAPTCHA e volume. Visite capsolver.com para ver os preços atuais.

O OpenClaw é gratuito?

O OpenClaw é de código aberto e gratuito para executar em seu próprio hardware. Você precisará de chaves de API para o provedor de modelo de IA de sua escolha e, para a resolução de CAPTCHA, uma conta do CapSolver com créditos.

Quanto tempo devo dizer para a IA esperar?

Para a maioria dos CAPTCHAs, 30-60 segundos é suficiente. O tempo real de resolução geralmente é de 5-20 segundos, mas adicionar um buffer extra garante confiabilidade. Se em dúvida, use 60 segundos.

Posso usar isso em um servidor sem tela?

Sim. Você precisará do Xvfb (X Virtual Framebuffer) para a tela, já que extensões do Chrome exigem um contexto de tela. Defina DISPLAY=:99 e execute Xvfb :99 em segundo plano. Também defina noSandbox: true na sua configuração do navegador.