原始链接: https://zclaw.dev
zclaw 是一款紧凑型 AI 代理，设计在 ESP32 微控制器上直接运行，使用 C 语言和 ESP-IDF/FreeRTOS 框架。它作为一个实用的助手，可以通过 Telegram 或 Web 中继进行控制，允许用户使用自然语言执行命令——例如设置提醒、控制 GPIO 引脚和安排任务。 其关键特性是极小的占用空间，目标固件大小为 888 KiB *包括*操作系统、网络和安全堆栈。这使得 zclaw 能够在资源受限的设备上高效运行。 项目文档指导用户完成设置、工具使用（包括构建自定义工具）、运行时理解、安全注意事项和开发流程。它支持各种 LLM 后端，如 Anthropic 和 OpenAI，并展示了利用设备端执行实现独特自动化可能性的用例。zclaw 优先提供在严格资源限制下有用的自动化功能。
chapter 0
zclaw is an ESP32-resident AI agent written in C. It runs as a practical assistant over Telegram or host relay, with scheduling, GPIO control, memory, and a tight firmware budget.
You send plain language, zclaw maps to tool calls, firmware executes on silicon.
You: In 20 minutes, check the garage sensor Agent: Created schedule #7: once in 20 min -> check the garage sensor
The 888 KiB target is an all-in firmware cap, not just zclaw application logic. It includes app code plus ESP-IDF/FreeRTOS runtime, Wi-Fi/networking, TLS/crypto, and cert bundle overhead.
Current default esp32s3 build (grouped loadable image bytes from idf.py -B build size-components; rows sum to total image size):
| Layer | Size | Share |
|---|---|---|
zclaw app logic (libmain.a) | 35,742 bytes (~34.9 KiB) | ~4.1% |
| Wi-Fi + networking stack | 397,356 bytes (~388.0 KiB) | ~45.7% |
| TLS/crypto stack | 112,922 bytes (~110.3 KiB) | ~13.0% |
| Cert bundle + app metadata | 99,722 bytes (~97.4 KiB) | ~11.5% |
| Other ESP-IDF/runtime/drivers/libc | 224,096 bytes (~218.8 KiB) | ~25.8% |
Total image size from this build is 869,838 bytes; padded zclaw.bin is 869,952 bytes (~849.6 KiB), under the 888 KiB cap.