zclaw – Persönlicher AI-Assistent, der auf dem ESP32 mit 888 KB läuft

• Ein ultraleichter AI-Assistent für ESP32-Boards, dessen gesamte Firmware-Größe auf unter 888 KiB begrenzt ist
• In C geschrieben und in der Lage, GPIO-Steuerung, Scheduling (cron), persistenten Speicher und benutzerdefinierte Tools per natürlicher Sprache zu kombinieren
• Das vollständige Image inklusive Wi-Fi, TLS/Verschlüsselung und Zertifikats-Bundle passt in 888 KiB, während der App-Code selbst nur etwa 25 KB groß ist
• Unterstützt die Anbindung an Telegram und Web-Relay-Chat sowie an wichtige LLM-Anbieter wie Anthropic, OpenAI und OpenRouter
• Auf ESP32-C3/S3/C6-Boards getestet und als Open Source (MIT-Lizenz) veröffentlicht, wodurch Embedded-AI-Experimente und Erweiterbarkeit ermöglicht werden

---

Projektüberblick

• zclaw ist ein persönlicher AI-Assistent für ESP32, der mit dem Ziel entwickelt wurde, die gesamte Firmware-Größe unter 888 KiB zu halten
  • Die Firmware umfasst die zclaw-Logik, die ESP-IDF/FreeRTOS-Laufzeit sowie Wi-Fi, TLS und das Zertifikats-Bundle
  • Der App-Code selbst ist nur etwa 25 KB groß und macht rund 4 % des Gesamt-Images aus
• Das Projekt ist in C geschrieben und unterstützt die Kombination von Tools über natürlichsprachliche Befehle, GPIO-Steuerung und Scheduling-Funktionen
• Mit dem Slogan „Fun to use, fun to hack on“ wird der Fokus auf Experimente für Entwickler und Erweiterbarkeit betont

Hauptfunktionen

• Bietet eine Chat-Oberfläche über Telegram oder Web-Relay
• Unterstützt zeitzonenbewusstes Scheduling: Wiederkehrende und einmalige Aufgaben mit daily, periodic, once usw.
• Funktionserweiterung über eingebaute und benutzerdefinierte Tools
• GPIO-Lese-/Schreibsteuerung sowie eingebaute Schutzmechanismen wie gpio_read_all
• Bietet persistenten Speicher, der auch nach einem Neustart erhalten bleibt
• Persona-Auswahl möglich: neutral, friendly, technical, witty
• Anbindung an LLM-Anbieter: Anthropic, OpenAI, OpenRouter

Hardware-Unterstützung

• Getestet auf: ESP32-C3, ESP32-S3, ESP32-C6
  • Andere ESP32-Varianten können mit manueller Konfiguration ebenfalls funktionieren
• Empfohlenes Board: Seeed XIAO ESP32-C3
• Stellt Skripte für den lokalen Entwicklungs- und Hacking-Loop bereit
  • build.sh, flash.sh, provision-dev.sh, monitor.sh usw.

Installation und Konfiguration

• Bietet einen Bootstrap-Einzeiler für macOS/Linux
  • bootstrap.sh klont das Repository und führt dann install.sh aus
• Mit Secure-Mode-Flash (--flash-mode secure) können verschlüsselte Zugangsdaten gespeichert werden
• Wi-Fi- und LLM-Zugangsdaten werden mit provision.sh eingerichtet
• Standardmäßige Begrenzung für LLM-Aufrufe: 100 pro Stunde, 1000 pro Tag (beim Kompilieren änderbar)
• Mit dem Testskript (web-relay.sh) kann die Geräteantwort überprüft werden

Lizenz- und Repository-Informationen

• MIT-Lizenz
• Offizielle Dokumentationsseite: zclaw.dev

[GN⁺]

Hacker-News-Kommentare

• Vielleicht habe ich das falsch verstanden, aber ich frage mich, ob hier ein kleines LLM eingebaut ist oder ob es nur ein Wrapper ist, der eine Internetverbindung braucht

  • Es ist ein Wrapper. Standardmäßig wird die OpenAI API verwendet. Siehe Code-Link
  • Die meisten Claw-Projekte sind so als Wrapper aufgebaut

• Der interessante Punkt daran, Claw auf einem ESP32 laufen zu lassen, ist nicht die Rechenleistung, sondern dass er immer eingeschaltet ist und fast keine Wartung braucht
  Ich betreibe Automatisierungs-Pipelines auf Linux-Servern, und das größte Problem ist nicht die AI-Logik, sondern das Host-Management. Updates, OOM, Reboots usw.
  Wenn der ESP32 Cloud-APIs proxyt und die Tool-Orchestrierung lokal übernimmt, ist er für einfache Agent-Loops sogar ein stabileres Deployment-Ziel

  • Ich frage mich, welches OS darauf installiert ist und wie Updates funktionieren
  • Stimme ich voll zu. Mikrocontroller sind praktisch selbstheilende Hosts — kein Paketmanager, keine Kernel-Upgrades, keine cgroup-Konfiguration. Nach einem Reset ist immer wieder derselbe Zustand da. Unter Linux gehört „nach dem regelmäßigen apt-Upgrade ist etwas kaputt“ dagegen zum Debugging-Alltag
  • Kann man Linux nicht auch einfach halten? Ich betreibe mehrere Apache-Server, und die laufen problemlos, solange ich sie nur zum EOL anfasse
  • Aber so entstehen mehr Fehlerquellen. Cloud-Server, Internet, Funkverbindung — wenn nur eines davon ausfällt, gibt es Probleme. Kein schlechter Ansatz, aber er reduziert die Probleme nicht

• Kann jemand die ADCs (Analog-Digital-Wandler) der ESP-SoCs aus Ingenieurssicht erklären?
  Leute mit Erfahrung sagen, sie seien heikel, aber wenn man richtig damit umgeht, könne man sie auf dem Niveau von STM-Chips nutzen
  Der ESP32 war einer der wenigen großen Chips mit eigener ISA und ist später zu RISC-V gewechselt

  • Die ADCs des ESP32 sind in den Spezifikationen sehr locker definiert. Wenn das nötige „Know-how“ Dinge wie präzise Kalibrierung oder Charakterisierung umfasst, die sich in der Produktion schwer umsetzen lassen, dann ist das wohl die Antwort
  • Die frühere ISA des ESP32 basierte auf IP, die von Tensilica übernommen wurde
  • Die ADCs des ESP32 sind nicht für hochpräzises Audio gedacht, sondern für einfache Eingabesteuerung. Also etwa ein Potentiometer anschließen und physische Eingaben erfassen. Für stabile Werte muss man mehrere Samples mitteln. Für langsam veränderliche Spannungen zur Überwachung sind sie aber völlig brauchbar

• Gibt es von solchen Claws auch eine kollaborative Version? Zum Beispiel eine self-hosted Variante, die eine Familie gemeinsam nutzen kann
  Ich habe gehört, dass OpenClaw Profile unterstützt, und frage mich, ob gleichzeitig private und geteilte Chats möglich sind

  • Ich habe selbst etwas Ähnliches gebaut. Einen Signal-basierten self-hosted Bot, der Gruppenchats unterstützt
    Zuletzt habe ich eine Lebensmittel-Automatisierung eingebaut — auf Basis vergangener Bestellungen wird eine Entwurfsliste erstellt, Familienmitglieder passen sie an, und der Agent erzeugt mit Browser-Tools den Warenkorb. Die Bezahlung ist noch manuell, aber es ist fast fertig. Solche Projekte dürften bald als Open Source erscheinen

• Ich habe ein paar ESP32s mit kleinen OLED-Displays und überlege, daraus ein intelligentes Tamagotchi zu bauen. Noch andere Ideen?

  • Ich habe etwas Ähnliches gemacht, aber am Ende läuft es auf das Schreiben einer Zustandsmaschine hinaus. Ein LLM kann Dinge wie „wann es essen sollte“ nicht wirklich selbst entscheiden. Am Ende fügt man immer mehr Variablen und Regeln hinzu und verliert dabei schnell die Richtung
  • Klingt cool. Ist das zufällig die Version mit dem ultrakleinen 0,46-Zoll-Display? Damit kann man für viele Zwecke lustige Sachen bauen

• Wenn man darüber nachdenkt, ist OpenClaw so etwas wie ROS (Robot Operating System) für die Welt der AI-Agenten
  Es definiert, wie verteilte Knoten miteinander interagieren, und man kombiniert mehrere Funktionsknoten zu einem größeren System

  • Aber gibt es dafür tatsächlich eine Spezifikation oder ein Protokoll? Für mich wirkt es eher wie eine Plattform mit diversen Integrationen obendrauf. So kam es mir nach etwa einer Woche Nutzung vor

• Ich bin ein einfacher Mensch. Schon beim Wort ESP32 drücke ich sofort Upvote

• Gibt es Empfehlungen für leichte Claw-artige Agenten unter Linux? Container oder Sandboxes brauche ich nicht

  • Ich nutze picoclaw
  • Wenn du einfach nur WhatsApp und Webchat willst, verwende ich meinen eigenen Web-Frontend-Aufsatz auf Basis von piclaw. Das läuft als über Tailscale erreichbare Web-App
  • zeroclaw wäre auch einen Blick wert

• Dieses Muster habe ich lange nicht mehr gesehen

  bash <(curl foo.sh)
  

  Normalerweise nimmt man

  curl foo.sh | bash
  

  aber beides ist sicherheitstechnisch riskant. Stattdessen würde ich Folgendes empfehlen

  curl foo.sh | tee /tmp/foo.sh | bash
  bash -c "$(curl foo.sh)"
  curl foo.sh -o /tmp/foo.sh && bash $_
  

  Ich bevorzuge die letzte Variante

  • Ich habe gehört, dass es besser sein soll, „curl direkt in bash zu pipen“ zu vermeiden und stattdessen erst in eine temporäre Datei zu speichern und dann auszuführen. Aber das Vertrauensproblem bleibt letztlich dasselbe. Vollständig sicher ist es nicht, solange man den Code nicht selbst gelesen hat
  • Noch sicherer wäre es, so etwas wie

    t=$(mktemp) && [ -w $t ] && curl foo.sh -o $t && echo "$t ..." | sha256sum -c - && bash $t
    

    zu verwenden und eine Hash-Prüfung hinzuzufügen
  • Wenn man es ganz sauber machen will, kann man es auch shell-unabhängig formulieren

• Diese Claw-Projekte haben strukturell eigentlich nichts Besonderes. Im Grunde reicht es, einem LLM die Berechtigung für API-Aufrufe zu geben

  • Was mich im OpenClaw-Hype überrascht hat, ist, wie viele Leute nicht einmal grundlegende Computerkonzepte verstehen. Es wirkt, als hätten sie noch nie außerhalb des node_modules-Ordners geschaut
  • Ich entwickle gerade selbst einen Claw, und zu sagen, da sei „nichts dabei“, ist so, als würde man ein Stück Sperrholz mit vier Rädern sehen und behaupten, ein Auto sei nichts Besonderes. Einen wirklich brauchbaren persönlichen Assistenten zu bauen, ist viel komplexer
  • Falls irgendwann alle rund um die Uhr persönliche Agenten laufen lassen, könnte das deutlich mehr Rechenressourcen erfordern, als man erwartet. Ob es tatsächlich so kommt, ist natürlich offen
  • Mit Programmierung ist es dasselbe. Das ist ungefähr so, als würde man sagen: „Man tippt doch nur auf einer Tastatur herum“
  • Am Ende werden wir wohl bald sehen, was passiert, wenn man einer Maus einen Keks gibt