ClawPy: Implementación Mínima de Python en un Solo Archivo de OpenClaw con Memoria de Experiencia

Qué es esto

ClawPy es una implementación minimalista en Python de un solo archivo de la arquitectura de ejecución autónoma de tareas de OpenClaw. Se ejecuta directamente en la terminal sin abstracciones pesadas, centrándose en la ingeniería de prompts en bruto, la lógica de máquinas de estado y la ejecución de subprocesos.

Detalles clave de implementación

El script refleja la mecánica central de OpenClaw:

• Árbol de tareas recursivo: Mantiene un archivo de estado tasks.txt que rastrea tareas incompletas. El sistema lee este archivo, decide si ejecutar tareas directamente o descomponerlas (hasta 4 niveles de profundidad), y automáticamente propaga el estado "Completado".
• Intérprete de código y autocorrección: Utiliza etiquetas XML personalizadas (<python>) para escribir y ejecutar scripts localmente. Cuando la ejecución encuentra un traceback, captura el stderr, fuerza una etiqueta de reflexión <error> para analizar el error, y reescribe el código hasta lograr un Código de Retorno 0.
• Sistema de memoria de experiencia: Cada vez que el agente ejecuta exitosamente un script (explicado mediante etiquetas <msg>) o reflexiona sobre un fallo (<error>), añade esa información a un archivo experience.txt. Al reiniciarse, el sistema inyecta un historial truncado de errores y éxitos pasados en el prompt del sistema, evitando la repetición de errores sintácticos o lógicos.

Casos de uso prácticos

El desarrollador creó esto para dos audiencias principales:

• Personas que quieren aprender exactamente cómo funciona el bucle autónomo internamente sin sumergirse en una base de código masiva
• Analistas de datos y cuantitativos que desean un agente liviano para escribir y corregir scripts de Pandas/financieros en su entorno local

Nota importante de seguridad: La herramienta ejecuta código Python generado directamente en tu máquina, por lo que el desarrollador recomienda ejecutarla en un entorno seguro o máquina virtual.

El proyecto está disponible en GitHub en https://github.com/EricChanBank/clawPy.git.