ClawPy: Implementação Python Minimalista de Arquivo Único do OpenClaw com Memória de Experiência

O Que É Isso

ClawPy é uma implementação Python minimalista, em um único arquivo, da arquitetura de execução autônoma de tarefas do OpenClaw. Ele roda diretamente no terminal sem abstrações pesadas, focando na engenharia de prompts bruta, na lógica da máquina de estados e na execução de subprocessos.

Detalhes Principais da Implementação

O script espelha as mecânicas centrais do OpenClaw:

• Árvore de Tarefas Recursiva: Mantém um arquivo de estado tasks.txt que rastreia tarefas incompletas. O sistema lê esse arquivo, decide se executa as tarefas diretamente ou as decompõe (até 4 níveis de profundidade), e automaticamente propaga o status "Concluído".
• Interpretador de Código e Autocorreção: Usa tags XML personalizadas (<python>) para escrever e executar scripts localmente. Quando a execução encontra um traceback, ele captura o stderr, força uma tag de reflexão <error> para analisar o bug e reescreve o código até alcançar o Código de Retorno 0.
• Sistema de Memória de Experiência: Toda vez que o agente executa um script com sucesso (explicado via tags <msg>) ou reflete sobre uma falha (<error>), ele adiciona essa percepção a um arquivo experience.txt. Ao ser reiniciado, o sistema injeta um histórico truncado de erros e sucessos passados no prompt do sistema, evitando a repetição de erros de sintaxe ou lógica.

Casos de Uso Práticos

O desenvolvedor criou isso para dois públicos principais:

• Pessoas que querem aprender exatamente como o loop autônomo funciona por baixo dos panos sem mergulhar em uma base de código massiva
• Analistas de dados e quants que querem um agente leve para escrever e corrigir scripts Pandas/financeiros em seu ambiente local

Nota Importante de Segurança: A ferramenta executa código Python gerado diretamente em sua máquina, então o desenvolvedor recomenda executá-la em um ambiente seguro ou máquina virtual.

O projeto está disponível no GitHub em https://github.com/EricChanBank/clawPy.git.