zclaw is unclaimed —

zclaw

zclaw.dev

zclaw is an ESP32-resident AI agent written in C. It runs as a practical assistant over Telegram or an optional host web relay, offering scheduling, GPIO control, memory, and tool calling within a tight firmware size budget (target under 888 KiB).

What it's for

Set timed reminders (e.g. 'Remind me in 20 minutes')Schedule recurring tasks (e.g. watering plants daily at a set time)Control GPIO pins directly via natural language (e.g. 'Set GPIO 5 high')Store contextual memory about device setup (e.g. remembering which sensor is on which GPIO pin)Trigger scheduled one-shot checks (e.g. checking a garage sensor after a delay)

Features 18

Boot loop guard entering safe mode after repeated failures
DHT11/DHT22 sensor reading (dht_read)
Factory reset via hardware GPIO hold or host erase scripts
Flash encryption modes (standard, encrypted dev, encrypted production)
GPIO control via natural language commands
Input validation and schema/string sanitation in tool handlers
Multiple LLM backend support (Anthropic, OpenAI, OpenRouter, Ollama)
Optional host web relay interface
Persistent memory of user-stated facts (e.g. sensor-to-GPIO mappings)
Provisioning gate requiring credentials before normal runtime
Rate limiting via request/hour and request/day caps
Raw I2C tools (i2c_scan, i2c_write, i2c_read, i2c_write_read)
Scheduling of one-shot and recurring jobs
Support for multiple ESP32 board variants (ESP32-C3, S3, C6, WROOM, T-Relay preset)
Telegram auth restricted to configured chat IDs
Telegram interface for chat-based control
Tool calling architecture mapping language to firmware actions
USB-local admin console for offline recovery (/gpio, /diag, /wifi, /bootcount, /reboot, /factory-reset)

At a glance

API

DeploymentInstalled (local)

Integrations

TelegramAnthropicOpenAIOpenRouterOllama

Resources

Changelog