ClawSweeper: Cómo el Bot Codex de OpenClaw Gestiona 7,000 Issues de GitHub Sin Errores

OpenClaw, el proyecto de asistente de IA de código abierto, acumuló más de 7,000 problemas y solicitudes de extracción abiertos para abril de 2026. La mayoría de los mantenedores en esa posición declararían la quiebra del rastreador de errores o contratarían un equipo de triaje. En cambio, los mantenedores de OpenClaw crearon un bot. ClawSweeper ahora revisa cada problema y PR abierto en un horario rotativo, redacta una propuesta de cierre autogenerada por Codex cuando la evidencia es sólida y aplica esos cierres a través de una vía de ejecución separada que solo se ejecuta cuando la propuesta aún es válida.

También es un estudio de caso de moderación. ClawSweeper no realiza cierres automáticos por corazonadas, nunca toca elementos creados por los mantenedores y se niega a aplicar cualquier cambio si la revisión subyacente dejó basura en el árbol de trabajo.

Esta guía explica qué hace ClawSweeper, cómo funcionan las tres vías juntas, las reglas de seguridad que impiden que cierre cosas que no debería y la configuración de Codex que impulsa cada revisión. Para obtener información sobre el modelo que realiza el trabajo pesado, consulte qué es GPT-5.5.

En resumen

• ClawSweeper es el bot de mantenimiento de OpenClaw para openclaw/openclaw, escaneando aproximadamente 7,000 elementos abiertos en un horario rotativo.
• Tres vías: un planificador elige qué revisar, la vía de revisión redacta propuestas de cierre, la vía de aplicación las ejecuta cada 15 minutos.
• Codex con gpt-5.5, alta capacidad de razonamiento, nivel de servicio rápido y un tiempo de espera de 10 minutos por elemento, escribe las revisiones.
• Los cierres solo ocurren en seis casos específicos: implementado, no reproducible, duplicado, fuera de alcance, incoherente o obsoleto con más de 60 días.
• Los elementos creados por los mantenedores, los elementos con PR de referencia abiertos y las etiquetas protegidas nunca se cierran automáticamente.
• El bot ha cerrado 10,217 elementos mediante automatización en total, pero la semana más reciente muestra una tasa de cierre del 0.1% por pasada de revisión; se inclina fuertemente a dejar las cosas abiertas.
• La licencia es MIT, la pila es TypeScript en Node 24 con pnpm, y las operaciones se ejecutan a través de una GitHub App.

El problema de mantenimiento que ClawSweeper resuelve

OpenClaw se presenta como "tu asistente personal de IA. Cualquier SO. Cualquier plataforma. Al estilo de la langosta." Este posicionamiento atrajo rápidamente a una amplia comunidad: 3,546 problemas abiertos y 3,457 solicitudes de extracción abiertas según la instantánea más reciente del panel de control del 27 de abril de 2026. Muchos de esos elementos hacen referencia a comportamientos corregidos hace tres versiones, duplican hilos más antiguos o describen características ahora más adecuadas para el ecosistema de plugins y habilidades de OpenClaw que para el repositorio principal.

El triaje manual con ese volumen no es realista. Cerrar lo incorrecto también es costoso, porque los colaboradores que se sienten ignorados dejan de contribuir. ClawSweeper aborda este problema separando el paso de decidir qué cerrar del paso de ejecutar el cierre, y dedicando la mayor parte de su energía a elementos donde la respuesta es claramente duplicada o incoherente.

Las tres vías

ClawSweeper se divide en tres procesos independientes. Cada uno registra en su propio directorio de informes y se puede pausar sin afectar a los demás.

Planificador

El planificador decide qué problemas y PR se revisan y con qué cadencia. Del README: “Los elementos nuevos y activos reciben más atención; los elementos más antiguos y silenciosos vuelven a una cadencia más lenta.” En la práctica, eso significa elementos "calientes" cada hora, elementos con menos de 30 días de antigüedad diariamente y problemas más antiguos semanalmente. La cadencia es intencional. Se desea revisar con frecuencia un informe de error reciente, en caso de que llegue más evidencia, y uno antiguo rara vez, porque es poco probable que la respuesta cambie.

Vía de revisión

La vía de revisión es donde Codex demuestra su valía. ClawSweeper elige un elemento, construye un fragmento de contexto con el título, el cuerpo, los comentarios y una instantánea del estado del repositorio en main, y luego entrega el fragmento a Codex. Codex devuelve un informe estructurado en formato Markdown con uno de tres veredictos: mantener abierto, cerrar porque X o evidencia insuficiente. El README es directo sobre el alcance: “La revisión es solo una propuesta. Nunca cierra elementos.”

Los informes residen en items/ hasta que la vía de aplicación los consume, y eso le da al sistema su propiedad de seguridad. Un humano puede leer cada cierre propuesto en el repositorio antes de que se realice.

Vía de aplicación

La aplicación se ejecuta cada 15 minutos. Recorre items/, extrae el informe más reciente para cada problema o PR abierto, y vuelve a validar la propuesta: ¿el informe sigue siendo consistente con el estado actual del problema (sin nuevos comentarios, sin etiqueta de mantenedor, sin PR de referencia abierto en la última hora), y es lo suficientemente reciente como para actuar? Si es así, la vía de aplicación cierra el elemento, publica la explicación redactada por Codex como un comentario y mueve el informe a closed/. Si algo ha cambiado, el informe se descarta y el planificador reconsidera el elemento en la siguiente pasada.

Esta división es la decisión de diseño más importante del proyecto. Codex nunca toca GitHub directamente, y la vía de aplicación nunca razona sobre la conveniencia del cierre; aplica la propuesta bajo nuevas condiciones.

Las reglas de cierre

ClawSweeper propone cierres solo para elementos que caen en una de seis categorías específicas, tomadas directamente del README:

• "implementado en main actual"
• "no reproducible en main actual"
• "duplicado o reemplazado por un problema/PR canónico"
• "concreto pero no accionable en este repositorio fuente" (más adecuado para el trabajo de habilidades o plugins de ClawHub)
• "lo suficientemente incoherente como para que no se pueda tomar ninguna acción"
• "problema obsoleto de más de 60 días con muy pocos datos para verificar"

Cualquier otra situación, incluyendo errores reproducibles, solicitudes de características válidas, reproducciones parciales y trabajo real pero sin prioridad, mantiene el elemento abierto. La tasa de cierre del 0.1% en la pasada de revisión más reciente (4 cierres propuestos entre 3,478 problemas revisados) le dice cuán agresivamente el prompt evita los falsos positivos.

Algunas protecciones se superponen a las reglas de cierre:

• Los elementos creados por los mantenedores nunca se cierran. Si un mantenedor presenta un problema, el bot lo deja en paz, independientemente de su antigüedad.
• Los PR de referencia abiertos bloquean el cierre. Si el problema #4321 tiene un PR abierto con Cierra #4321 en el cuerpo, ClawSweeper espera.
• Las etiquetas protegidas omiten el bot por completo. Etiquete un problema como mantener-abierto (o cualquier lista de etiquetas que configuren los mantenedores) y el planificador lo omitirá.

Configuración de Codex

La configuración de Codex es la parte que más vale la pena tomar prestada para cualquier equipo que cree su propia automatización:

gpt-5.5

Aquí importan algunos detalles. El modo de razonamiento alto detecta los duplicados que parecen obvios para un humano después de veinte segundos, pero que requieren seguir cinco hilos vinculados para verificar. El nivel de servicio rápido mantiene los costos predecibles en una acumulación de 7,000 elementos. El tiempo de espera de 10 minutos es un "kill" duro, no una advertencia; un elemento que tarda más se descarta para la siguiente pasada en lugar de bloquear la cola.

El entorno de Codex también se ejecuta sin tokens de escritura de GitHub. El README lo expresa claramente: "Las revisiones fallan si Codex deja cambios rastreados o sin rastrear." Esto obliga al revisor a comportarse como un analista de solo lectura; cualquier efecto secundario es un error, no una característica.

Si desea utilizar el mismo modelo de forma interactiva antes de conectarlo a un bot, la CLI de Codex es la ruta gratuita más fácil a GPT-5.5. Para un modelo de costos en el acceso programático a la API, consulte el desglose de precios de GPT-5.5 y la guía de uso de la API de GPT-5.5.

Configuración local

Clonar ClawSweeper y ejecutarlo localmente es sencillo. El repositorio espera Node 24 y pnpm a través de corepack:

git clone https://github.com/openclaw/clawsweeper.git
cd clawsweeper
source ~/.profile
corepack enable
pnpm install
pnpm run build

Algunos secretos deben estar presentes antes de que las vías comiencen:

• OPENAI_API_KEY: autentica a Codex para la vía de revisión.
• CLAWSWEEPER_APP_ID: ID de la GitHub App (3306130 para la instalación de producción).
• CLAWSWEEPER_APP_PRIVATE_KEY: la clave privada utilizada para generar tokens de instalación de corta duración.
• OPENCLAW_GH_TOKEN: opcional, recurre a un token de acceso personal si la ruta de la App falla.

Puede ejecutar la vía de revisión en cualquier repositorio de su propiedad. La vía de aplicación limita intencionalmente sus operaciones de escritura a openclaw/openclaw a menos que reconfigure los permisos de la GitHub App.

Para los equipos que prefieren una clave de API de pago pero desean el mismo comportamiento de Codex, las rutas gratuitas de GPT-5.5 describen alternativas que se canalizan a través de créditos de prueba o pasarelas agregadoras.

Instantánea del panel de control

El README incluye un panel de control público que se actualiza con cada pase de aplicación. A partir de la instantánea más reciente:

• 7,003 elementos abiertos totales (3,546 problemas + 3,457 PRs)
• 3,478 problemas revisados en los últimos 7 días
• 4 propuestas de cierre de problemas (0.1% de los revisados)
• 10,217 elementos totales cerrados por automatización desde el lanzamiento

El número del 0.1% es revelador. ClawSweeper no está optimizando para tener la bandeja de entrada de problemas a cero; está optimizando para "nunca cerrar algo que un contribuidor defendería si se le preguntara". En más de 10,000 cierres, esa postura conservadora es lo que mantuvo el proyecto lo suficientemente creíble como para que los colaboradores siguieran abriendo nuevos problemas.

Por qué esto es importante para los equipos de API

La mayoría de los productos de API en GitHub siguen el mismo camino que OpenClaw. El SDK o la especificación se encuentran en un repositorio público, el rastreador de problemas se llena con informes de errores y solicitudes de características mixtos, y el triaje se retrasa. Si publica una especificación OpenAPI desde Apidog y acepta contribuciones de la comunidad en GitHub, la arquitectura de ClawSweeper es portable. Las partes valiosas no son los prompts, ya que están ligadas al dominio de OpenClaw. Las partes valiosas son la separación de vías, las reglas estrictas de cierre y la política de ejecutar Codex sin acceso de escritura.

Puede aplicar el mismo enfoque en tres pasos:

1. Ejecute un trabajo de revisión impulsado por Codex en una muestra de su rastreador. Haga que produzca informes en Markdown sin confirmar nada.
2. Agregue las reglas de seguridad: nunca cierre elementos del mantenedor, respete las etiquetas protegidas, ceda ante los PR abiertos.
3. Agregue una vía de aplicación solo cuando los informes de revisión se vean correctos al leerlos manualmente. Conéctela para cerrar como máximo un puñado por día hasta que se genere confianza.

Si está validando la superficie de API que describen esos problemas, Apidog maneja el lado del contrato. El mismo documento OpenAPI impulsa servidores simulados, pruebas automatizadas y la documentación que sus colaboradores leen antes de presentar un error. Combinar un bot de triaje con una especificación con versiones estrictas generalmente reduce la tasa de problemas duplicados a la mitad antes de que el bot se ejecute. Descargue Apidog si desea comenzar con la disciplina de la especificación.

Límites y compromisos de diseño

Algunas cosas que ClawSweeper deliberadamente no hace:

• No escribe código. Sin PRs, sin parches, sin comentarios de revisión que sugieran soluciones. Ese trabajo pertenece a otros bots de OpenClaw.
• No razona sobre la prioridad. El cierre es binario; nada se "desprioriza" ni se etiqueta por el bot.
• No aprende de cierres anteriores. Cada revisión comienza de nuevo con main. Las decisiones anteriores solo aparecen como informes históricos en closed/, no como datos de ajuste fino.

Estos compromisos son la razón por la que el bot se mantiene predecible. También dejan espacio para la automatización adyacente, como un bot de etiquetado, un pinger de PRs obsoletos o un redactor de notas de lanzamiento, sin interferir en el estrecho cometido de ClawSweeper.

Preguntas frecuentes

¿Con qué frecuencia ClawSweeper cierra problemas automáticamente?La vía de aplicación se ejecuta cada 15 minutos, pero la mayoría de los ciclos no producen cierres. La tasa de cierre del 0.1% por revisión el 27 de abril de 2026 significa aproximadamente 4 cierres entre 3,478 problemas revisados durante una semana. Para obtener información sobre el modelo detrás de las revisiones, consulte qué es GPT-5.5.

¿Puedo ejecutar ClawSweeper en mi propio repositorio?Sí. Clone el repositorio, configure su propia GitHub App con acceso de lectura/escritura en el objetivo y apunte CLAWSWEEPER_APP_ID y CLAWSWEEPER_APP_PRIVATE_KEY hacia ella. La revisión de repositorios de otras personas es de solo lectura por defecto.

¿ClawSweeper requiere un plan de OpenAI de pago?La vía de revisión se autentica a través de OPENAI_API_KEY, que es una credencial de API de pago. Si solo desea ejecutar revisiones de forma interactiva en lugar de a gran escala, la CLI de Codex en un plan gratuito de ChatGPT funciona.

¿Qué impide que Codex cierre errores reales?Tres cosas. La lista de reglas de cierre específicas, las exclusiones para mantenedores y etiquetas protegidas, y el paso de revalidación de la vía de aplicación que descarta cualquier propuesta si el problema subyacente ha cambiado desde la revisión.

¿ClawSweeper es de código abierto?Sí, tiene licencia MIT, con el código fuente en GitHub en openclaw/clawsweeper. El proyecto principal OpenClaw es un repositorio separado con su propia guía de contribución.