ClawPy: Минимальная однодокументная реализация OpenClaw на Python с памятью опыта

Что это такое

ClawPy — это минималистичная, однофайловая реализация на Python архитектуры автономного выполнения задач OpenClaw. Он работает напрямую в терминале без тяжёлых абстракций, фокусируясь на непосредственной инженерии промптов, логике конечного автомата и выполнении подпроцессов.

Ключевые детали реализации

Скрипт повторяет основные механизмы OpenClaw:

• Рекурсивное дерево задач: Поддерживает файл состояния tasks.txt, который отслеживает незавершённые задачи. Система читает этот файл, решает, выполнять ли задачи напрямую или декомпозировать их (до 4 уровней глубины), и автоматически поднимает статус "Completed".
• Интерпретатор кода и самовосстановление: Использует пользовательские XML-теги (<python>) для написания и запуска скриптов локально. Когда выполнение сталкивается с трассировкой ошибки, он перехватывает stderr, принудительно добавляет тег отражения <error> для анализа ошибки и переписывает код до достижения кода возврата 0.
• Система памяти опыта: Каждый раз, когда агент успешно выполняет скрипт (объясняя через теги <msg>) или анализирует сбой (<error>), он добавляет это понимание в файл experience.txt. При повторном запуске система внедряет усечённую историю прошлых ошибок и успехов в системный промпт, предотвращая повторение синтаксических или логических ошибок.

Практические варианты использования

Разработчик создал это для двух основных аудиторий:

• Людей, которые хотят точно понять, как работает автономный цикл, не погружаясь в огромную кодовую базу
• Аналитиков данных и количественных аналитиков, которым нужен лёгкий агент для написания и исправления скриптов Pandas/финансовых скриптов в их локальной среде

Важное примечание по безопасности: Инструмент запускает сгенерированный код Python напрямую на вашем компьютере, поэтому разработчик рекомендует запускать его в безопасной среде или виртуальной машине.

Проект доступен на GitHub по адресу https://github.com/EricChanBank/clawPy.git.