ClawPy: 경험 메모리를 갖춘 OpenClaw의 최소 단일 파일 Python 구현

이것이 무엇인가요

ClawPy는 OpenClaw의 자율적 작업 실행 아키텍처를 최소화된 단일 파일 Python으로 구현한 것입니다. 무거운 추상화 없이 터미널에서 직접 실행되며, 원시 프롬프트 엔지니어링, 상태 머신 로직, 하위 프로세스 실행에 중점을 둡니다.

주요 구현 세부사항

이 스크립트는 OpenClaw의 핵심 메커니즘을 반영합니다:

• 재귀적 작업 트리: 완료되지 않은 작업을 추적하는 tasks.txt 상태 파일을 유지합니다. 시스템은 이 파일을 읽고, 작업을 직접 실행할지 분해할지(최대 4단계 깊이까지) 결정하며, "완료됨" 상태를 자동으로 상위로 전파합니다.
• 코드 인터프리터 및 자가 치유: 사용자 정의 XML 태그(<python>)를 사용하여 로컬에서 스크립트를 작성하고 실행합니다. 실행 중 트레이스백이 발생하면 stderr을 포착하고, <error> 반성 태그를 강제로 생성하여 버그를 분석한 후, 반환 코드 0을 달성할 때까지 코드를 다시 작성합니다.
• 경험 메모리 시스템: 에이전트가 스크립트를 성공적으로 실행할 때마다(<msg> 태그로 설명됨) 또는 충돌을 반성할 때(<error>), 그 통찰력을 experience.txt 파일에 추가합니다. 다시 부팅되면 시스템은 과거 실수와 성공의 축약된 기록을 시스템 프롬프트에 주입하여 구문 또는 논리적 오류의 반복을 방지합니다.

실용적인 사용 사례

개발자는 이를 두 가지 주요 대상층을 위해 만들었습니다:

• 방대한 코드베이스에 깊이 파고들지 않고도 자율 루프가 내부적으로 어떻게 작동하는지 정확히 배우고 싶은 사람들
• 로컬 환경에서 Pandas/금융 스크립트를 작성하고 수정할 가벼운 에이전트를 원하는 데이터 분석가 및 퀀트

중요한 보안 참고사항: 이 도구는 생성된 Python 코드를 사용자의 컴퓨터에서 직접 실행하므로, 개발자는 안전한 환경이나 가상 머신에서 실행할 것을 권장합니다.

이 프로젝트는 GitHub의 https://github.com/EricChanBank/clawPy.git에서 이용 가능합니다.