Main Branch

Fundamentals first, always

Artículos

Por Qué Construí Claw Relay

Los agentes de IA pueden escribir código y buscar en la web, pero en el momento en que necesitan un navegador real con sesiones reales, todo se rompe. Así que construí un relay que les da el mío.

Andrea Griffiths 3 min de lectura 🌐 Read in English 🌐 阅读中文版
Claw Relay Agentes IA Automatización de Navegador Open Source Chrome
Escuchar artículo

Read in English →

Por Qué Construí Claw Relay

Mi agente de IA necesitaba un navegador. No un Chromium headless en un sandbox. Un navegador real, con mis logins, mis cookies, mis sesiones intactas.

Eso no existía. Así que lo construí.

El Problema

Los agentes están mejorando mucho escribiendo código, buscando en la web, leyendo documentación. Pero en el momento en que necesitan usar un sitio web de verdad, todo se desmorona.

La mayoría de las herramientas de navegador te dan una instancia fresca de Chromium sin estado. Cada sesión empieza de cero. Sin logins, sin cookies, sin historial. Está bien si estás scrapeando. Es inútil si intentas hacer trabajo real.

Yo quería que mi agente sacara el estado de deploy de Railway, tomara screenshots de un dashboard interno, llenara un formulario, generara un PDF de una herramienta que vive detrás de autenticación. Todo lo que requiere estar logueado como yo, en mi navegador.

Un ejemplo concreto. Railway requiere login para ver el estado de deploy. Un navegador headless no puede llegar ahí. No tiene sesión. Con Claw Relay, mi agente navega a railway.app, lee el estado de deploy directo de la página, y me manda un screenshot. Sin pelear con APIs. Sin re-autenticarse. Solo el navegador haciendo lo que los navegadores hacen.

Qué Hace Claw Relay

Se sienta entre tu agente y Chrome. Tu agente manda acciones por WebSocket: navegar, hacer clic, tomar screenshots, leer la página. Claw Relay verifica autenticación, aplica permisos y rate limits, y luego reenvía la acción a Chrome por CDP (Chrome DevTools Protocol).

npx @acolombiadev/claw-relay

Un comando. Lanza una ventana dedicada de Chrome, inicia el relay y genera config con tokens aleatorios. Inicia sesión en lo que necesites en esa ventana. Esas sesiones persisten entre reinicios.

Tu agente se conecta y obtiene un navegador real con sesiones reales. No una simulación.

Qué Lo Hace Diferente

Sesiones persistentes. Inicia sesión una vez. Las cookies sobreviven reinicios. Tu agente no tiene que re-autenticarse cada vez.

Scoping de permisos. Tú decides qué puede hacer el agente. ¿Solo navegación? ¿Interacción completa? ¿Ejecución de JavaScript? Se configura por agente, no globalmente.

Restricciones de sitios. Allowlist o blocklist de dominios específicos. El agente puede leer docs.railway.app pero no puede tocar tu banco.

Rate limiting. Throttling incorporado para que un agente no bombardee un sitio con 50 requests por segundo.

Auditoría. Cada acción se registra con timestamps. Puedes ver exactamente qué hizo tu agente, qué intentó hacer, y qué fue bloqueado.

Es solo Chrome. No Playwright en un contenedor Docker que no puedes ver. No Puppeteer detrás de tres capas de abstracción. Una ventana normal de Chrome que puedes mirar, clickear e inspeccionar.

Tu navegador nunca sale de tu máquina.

Cómo Lo Uso

Corro Claw Relay en Railway con una instancia persistente de Chrome. Mi agente se conecta por WSS y lo usa como su navegador permanente. Toma screenshots de previews de deploy, lee dashboards internos, llena formularios, genera PDFs de herramientas que requieren login. Todo con mis sesiones existentes.

El agente ve un navegador real. El navegador ve un usuario real.

Pruébalo

npx @acolombiadev/claw-relay

Eso es todo. Open source. Licencia MIT.

GitHub → Docs →


Versión en Audio: Este artículo también está disponible en audio, generado usando Fish Audio con mi voz clonada. Fish Audio hace increíblemente fácil crear habla natural a partir de texto — simplemente pego el contenido del artículo y obtengo audio de alta calidad en segundos.

Sobre la Autora: Andrea Griffiths es Senior Developer Advocate en GitHub, donde ayuda a equipos de ingeniería a adoptar y escalar tecnologías de desarrolladores. Le apasiona hacer conceptos técnicos accesibles—tanto para humanos como para agentes de IA. Conéctate con ella en LinkedIn, GitHub, o Twitter/X. · Leer en inglés · 阅读中文版