- 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
Noch keine Kommentare.