ClawPy: Minimale Einzeldatei-Python-Implementierung von OpenClaw mit Erfahrungsspeicher

Was das ist

ClawPy ist eine minimale, einzeilige Python-Implementierung der autonomen Aufgabenausführungsarchitektur von OpenClaw. Es läuft direkt im Terminal ohne komplexe Abstraktionen und konzentriert sich auf Prompt-Engineering, Zustandsmaschinenlogik und Subprozessausführung.

Wichtige Implementierungsdetails

Das Skript spiegelt die Kernmechanismen von OpenClaw wider:

• Rekursiver Aufgabenbaum: Verwaltet eine tasks.txt-Statusdatei, die unvollständige Aufgaben verfolgt. Das System liest diese Datei, entscheidet, ob Aufgaben direkt ausgeführt oder zerlegt werden sollen (bis zu 4 Ebenen tief), und meldet automatisch den Status "Abgeschlossen".
• Code-Interpreter & Selbstheilung: Verwendet benutzerdefinierte XML-Tags (<python>), um Skripte lokal zu schreiben und auszuführen. Bei einem Traceback fängt es die stderr ab, erzwingt ein <error>-Reflexionstag zur Fehleranalyse und schreibt den Code neu, bis Rückgabecode 0 erreicht wird.
• Erfahrungsgedächtnissystem: Jedes Mal, wenn der Agent ein Skript erfolgreich ausführt (erklärt durch <msg>-Tags) oder über einen Absturz reflektiert (<error>), wird diese Erkenntnis in eine experience.txt-Datei angehängt. Beim Neustart injiziert das System eine gekürzte Historie vergangener Fehler und Erfolge in den System-Prompt, um Wiederholungen von Syntax- oder Logikfehlern zu verhindern.

Praktische Anwendungsfälle

Der Entwickler hat dies für zwei Hauptzielgruppen erstellt:

• Personen, die genau verstehen möchten, wie die autonome Schleife funktioniert, ohne in eine umfangreiche Codebasis einzutauchen
• Datenanalysten und Quants, die einen schlanken Agenten zum Schreiben und Reparieren von Pandas/Finanzskripten in ihrer lokalen Umgebung wünschen

Wichtiger Sicherheitshinweis: Das Tool führt generierten Python-Code direkt auf Ihrem Computer aus, daher empfiehlt der Entwickler, es in einer sicheren Umgebung oder virtuellen Maschine auszuführen.

Das Projekt ist auf GitHub unter https://github.com/EricChanBank/clawPy.git verfügbar.