zclaw: personal AI assistant in under 888 KB, running on an ESP32

Hacker News · Feb 21, 2026 · Collected from RSS

Full Article

zclaw The smallest possible AI personal assistant for ESP32. zclaw is written in C and runs on ESP32 boards with a strict firmware budget target of <= 888 KB on the default build. It supports scheduled tasks, GPIO control, persistent memory, and custom tool composition through natural language. Fun to use, fun to hack on. Full Documentation Use the docs site for complete guides and reference. Full documentation README (web) Complete README (verbatim) Quick Start One-line bootstrap (macOS/Linux): bash <(curl -fsSL https://raw.githubusercontent.com/tnm/zclaw/main/scripts/bootstrap.sh) Already cloned? ./install.sh Non-interactive install: ./install.sh -y Important setup notes: bootstrap.sh clones/updates the repo and then runs ./install.sh. For encrypted credentials in flash, use secure mode (--flash-mode secure in install flow, or ./scripts/flash-secure.sh directly). After flashing, provision WiFi + LLM credentials with ./scripts/provision.sh. Quick validation path: run ./scripts/web-relay.sh and send a test message to confirm the device can answer. If serial port is busy, run ./scripts/release-port.sh and retry. Full setup/provisioning details are in the docs site index. Highlights Chat via Telegram or hosted web relay Timezone-aware schedules (daily, periodic, and one-shot once) Built-in + user-defined tools GPIO read/write control with guardrails Persistent memory across reboots Provider support for Anthropic, OpenAI, and OpenRouter Hardware Tested targets: ESP32-C3, ESP32-S3, and ESP32-C6. Other ESP32 variants should work fine (some may require manual ESP-IDF target setup). Tests reports are very welcome! Recommended starter board: Seeed XIAO ESP32-C3 Useful Scripts ./scripts/build.sh - Build firmware ./scripts/flash.sh - Flash firmware ./scripts/flash-secure.sh - Flash with encryption ./scripts/provision.sh - Provision credentials to NVS ./scripts/monitor.sh - Serial monitor ./scripts/emulate.sh - Run QEMU profile ./scripts/web-relay.sh - Hosted relay + mobile chat UI ./scripts/benchmark.sh - Benchmark relay/serial latency ./scripts/docs-site.sh - Serve docs site ./scripts/test.sh - Run host/device test flows ./scripts/test-api.sh - Run live provider API checks (manual/local) Latency Benchmarking Relay path benchmark (includes web relay processing + device round trip): ./scripts/benchmark.sh --mode relay --count 20 --message "ping" Direct serial benchmark (host round trip + first response time). If firmware logs METRIC request ... lines, the report also includes device-side timing: ./scripts/benchmark.sh --mode serial --serial-port /dev/cu.usbmodem1101 --count 20 --message "ping" License MIT