Clawnet para Openclaw

Clawnet é uma habilidade de navegador Chromium furtivo para agentes de IA que automatiza o desvio de bots, gerenciamento de proxy residencial e resolução de CAPTCHA.

ekenesbek
v0.2.2
Mar 4, 2026
1
710
3

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install pets-browser

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o pets-browser usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é Clawnet?

Clawnet é uma habilidade de navegador furtivo especializada, projetada para capacitar agentes de IA com capacidades avançadas de navegação e interação na web dentro do ecossistema Openclaw Skills. Ele fornece uma instância endurecida do Chromium que ignora automaticamente sistemas sofisticados de detecção de bots como Cloudflare, DataDome e PerimeterX. Ao integrar proxies residenciais de mais de 10 países e resolução de CAPTCHA integrada, o Clawnet permite que os agentes se comportem como usuários reais, garantindo altas taxas de sucesso para scraping, preenchimento de formulários e fluxos de trabalho web complexos de várias etapas.

Esta habilidade foi projetada para substituir implementações brutas de Playwright ou Puppeteer, oferecendo uma camada de observação otimizada para IA. Em vez de seletores CSS frágeis, ela usa árvores de acessibilidade estruturadas com IDs de referência clicáveis, tornando significativamente mais fácil para os agentes entenderem e interagirem com páginas web modernas e dinâmicas. O Clawnet é um componente essencial da biblioteca Openclaw Skills para qualquer desenvolvedor que esteja construindo agentes autônomos que exijam acesso confiável à web.

Casos de uso do Clawnet

  • Ignorar proteção de bots e muros anti-scraping em sites de alta segurança.
  • Automatizar transações web de várias etapas, como reservas de restaurantes ou compras de e-commerce.
  • Realizar pesquisas de mercado localizadas usando proxies residenciais de regiões geográficas específicas.
  • Resolver reCAPTCHA, hCaptcha e Cloudflare Turnstile sem intervenção manual.
  • Interagir com componentes de UI complexos, incluindo Shadow DOM e editores de texto rico.

Como o Clawnet funciona

  1. O agente inicia uma sessão furtiva usando a função launchBrowser, que configura o proxy residencial e os cabeçalhos anti-detecção.
  2. O navegador navega até a URL de destino enquanto o daemon de fundo gerencia o ciclo de vida persistente.
  3. O agente chama snapshotAI para gerar uma árvore de acessibilidade estruturada da página, mapeando elementos para IDs de referência exclusivos.
  4. Usando essas referências, o agente realiza ações semelhantes às humanas, como clickRef ou fillRef, para interagir com elementos específicos da UI.
  5. Se um desafio for detectado, solveCaptcha é acionado para lidar com a validação automaticamente.
  6. Para cada etapa significativa, o agente tira uma captura de tela para manter um log visual e fornecer prova de ação ao usuário.
  7. Várias abas podem ser abertas e gerenciadas via variáveis exclusivas para lidar com tarefas paralelas em diferentes domínios.

Configuração do Clawnet

Instale a habilidade via linha de comando:

clawhub install clawnet

Para ambientes Linux ou Docker, certifique-se de que todas as dependências do Chromium estejam presentes:

npx playwright install-deps chromium

Configure suas variáveis de ambiente para os modos de proxy gerenciado ou BYO:

# Para modo gerenciado (Padrão)
CN_AGENT_TOKEN=CN1.<agentId>.<agentSecret>

# Para modo Traga Seu Próprio (BYO)
CN_PROXY_PROVIDER=decodo
CN_PROXY_USER=seu_usuario
CN_PROXY_PASS=sua_senha
TWOCAPTCHA_KEY=sua_chave_2captcha

Esquema de Dados e Taxonomia de Clawnet

Clawnet mantém dados estruturados para sessões, logs e mapeamento de elementos como parte do padrão Openclaw Skills.

Tipo de Dado Armazenamento/Formato Descrição
Credenciais ~/.clawnet/agent-credentials.json Armazena agentId e agentSecret para acesso à API.
Logs de Sessão ~/.clawnet/logs/<id>.jsonl Registros JSONL abrangentes de todas as ações, navegações e erros.
Snapshots de Página Árvore de Acessibilidade YAML Representação do DOM amigável para IA com mapeamento de elementos [ref=eN].
Metadados da Aba Objeto Tab Rastreia tabId, url, label e status ativo.
Capturas de Tela Base64 PNG Capturas de estado visual para comunicação e verificação do usuário.

Recursos avançados do Clawnet

  • Orquestração de várias abas com variáveis de escopo para processamento web paralelo.
  • Simulação de interação humana, incluindo movimentos de mouse em curva de Bezier e velocidades de digitação naturais.
  • Persistência do daemon de fundo que mantém as sessões do navegador vivas em várias execuções de script.
  • Execução de ações em lote para minimizar a latência e as viagens de ida e volta do LLM para fluxos de várias etapas.
  • Integração profunda com Shadow DOM e editores contenteditable para interações complexas em aplicativos.
  • Log de sessão detalhado para auditoria do raciocínio do agente e depuração de falhas na web dentro da estrutura Openclaw Skills.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

Apresentou*