Clawnet para Openclaw

Clawnet es una habilidad de navegador Chromium sigiloso para agentes de IA que automatiza la evasión de bots, la gestión de proxies residenciales y la resolución de CAPTCHA.

ekenesbek
v0.2.2
Mar 4, 2026
1
710
3

Instalar y Descargar

1. ClawHub CLI

La forma más rápida de instalar una habilidad directamente desde el registro.

npx clawhub@latest install pets-browser

2. Instalación manual

Copia la carpeta de la habilidad a una de estas ubicaciones

Global
~/.openclaw/skills/
Espacio de trabajo
<project>/skills/

Prioridad: Espacio de trabajo > Local > Integrado

3. Instalación del prompt

Copia este prompt en OpenClaw para instalarlo automáticamente.

Ayúdame a instalar pets-browser usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).

¿Prefieres descargar?

Obtén los archivos originales de la habilidad en un archivo ZIP.

¿Qué es Clawnet?

Clawnet es una habilidad de navegador sigiloso especializada, diseñada para dotar a los agentes de IA con capacidades avanzadas de navegación e interacción web dentro del ecosistema de Openclaw Skills. Proporciona una instancia de Chromium blindada que evade automáticamente sistemas sofisticados de detección de bots como Cloudflare, DataDome y PerimeterX. Al integrar proxies residenciales de más de 10 países y resolución de CAPTCHA incorporada, Clawnet permite que los agentes se comporten como usuarios reales, garantizando altas tasas de éxito para el scraping, el llenado de formularios y flujos de trabajo web complejos de varios pasos.

Esta habilidad está diseñada para reemplazar las implementaciones directas de Playwright o Puppeteer ofreciendo una capa de observación optimizada para IA. En lugar de selectores CSS frágiles, utiliza árboles de accesibilidad estructurados con IDs de referencia cliqueables, lo que facilita significativamente que los agentes comprendan e interactúen con páginas web modernas y dinámicas. Clawnet es un componente esencial de la biblioteca Openclaw Skills para cualquier desarrollador que construya agentes autónomos que requieran un acceso web confiable.

Casos de uso de Clawnet

  • Evadir la protección contra bots y muros anti-scraping en sitios web de alta seguridad.
  • Automatizar transacciones web de varios pasos, como reservas en restaurantes o compras en e-commerce.
  • Realizar investigaciones de mercado localizadas utilizando proxies residenciales de regiones geográficas específicas.
  • Resolver reCAPTCHA, hCaptcha y Cloudflare Turnstile sin intervención manual.
  • Interactuar con componentes de UI complejos, incluyendo Shadow DOM y editores de texto enriquecido.

Cómo funciona Clawnet

  1. El agente inicia una sesión sigilosa mediante la función launchBrowser, que configura el proxy residencial y las cabeceras anti-detección.
  2. El navegador navega a la URL de destino mientras el demonio en segundo plano gestiona el ciclo de vida persistente.
  3. El agente llama a snapshotAI para generar un árbol de accesibilidad estructurado de la página, mapeando elementos a IDs de referencia únicos.
  4. Utilizando estas referencias, el agente realiza acciones de tipo humano como clickRef o fillRef para interactuar con elementos específicos de la interfaz.
  5. Si se detecta un desafío, se activa solveCaptcha para gestionar la validación automáticamente.
  6. En cada paso significativo, el agente toma una captura de pantalla para mantener un registro visual y proporcionar pruebas de la acción al usuario.
  7. Se pueden abrir y gestionar múltiples pestañas mediante variables únicas para manejar tareas paralelas en diferentes dominios.

Configuración de Clawnet

Instala la habilidad a través de la línea de comandos:

clawhub install clawnet

Para entornos Linux o Docker, asegúrate de que todas las dependencias de Chromium estén presentes:

npx playwright install-deps chromium

Configura tus variables de entorno para los modos de proxy gestionado o propio (BYO):

# Para modo gestionado (Predeterminado)
CN_AGENT_TOKEN=CN1.<agentId>.<agentSecret>

# Para modo trae tu propio proxy (BYO)
CN_PROXY_PROVIDER=decodo
CN_PROXY_USER=tu_usuario
CN_PROXY_PASS=tu_contraseña
TWOCAPTCHA_KEY=tu_clave_2captcha

Esquema de datos y taxonomía de Clawnet

Clawnet mantiene datos estructurados para sesiones, registros y mapeo de elementos como parte del estándar de Openclaw Skills.

Tipo de dato Almacenamiento/Formato Descripción
Credenciales ~/.clawnet/agent-credentials.json Almacena agentId y agentSecret para acceso a la API.
Registros de sesión ~/.clawnet/logs/<id>.jsonl Registros JSONL exhaustivos de todas las acciones, navegaciones y errores.
Instantáneas de página Árbol de accesibilidad YAML Representación del DOM amigable para IA con mapeo de elementos [ref=eN].
Metadatos de pestaña Objeto Tab Rastrea tabId, url, label y estado activo.
Capturas de pantalla Base64 PNG Capturas de estado visual para comunicación con el usuario y verificación.

Funciones avanzadas de Clawnet

  • Orquestación de múltiples pestañas con variables de ámbito para procesamiento web paralelo.
  • Simulación de interacción humana, incluyendo movimientos de ratón con curvas de Bezier y velocidades de escritura naturales.
  • Persistencia del demonio en segundo plano que mantiene vivas las sesiones del navegador a través de múltiples ejecuciones de scripts.
  • Ejecución de acciones por lotes para minimizar la latencia y los viajes de ida y vuelta del LLM en flujos de varios pasos.
  • Integración profunda con Shadow DOM y editores contenteditable para interacciones complejas con aplicaciones.
  • Registro detallado de sesiones para auditar el razonamiento del agente y depurar fallos web dentro del marco de Openclaw Skills.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

Presentado*