ESPCLAW // AGENTS THAT TOUCH REAL HARDWARE

Put a programmable runtime on the board, not just a fixed firmware image.

ESPClaw turns ESP32-class boards into inspectable agent systems with reusable components, installable Lua apps, persistent behaviors, operator-visible logs, and OTA-safe iteration loops.

Flash a board Try the browser lab

GOAL

Shorten the loop from idea to hardware behavior.

Flash once, then iterate with OTA, installable apps, shareable components, and a tool-using agent loop instead of rebuilding firmware for every experiment.

PHILOSOPHY

Boring architecture. Visible state. Reversible operations.

Workspace files, logs, tasks, behaviors, and tool activity stay inspectable so the runtime behaves like an operable system instead of a black box.

SHAPE

Components for reuse. Apps for features. Behaviors for persistence.

ESPClaw encourages community-built drivers and modules while keeping user-facing features explicit and deployable.

CAPABILITIES

Designed for boards with real constraints.

GPIO, PWM, ADC, I2C, SPI, UART, Wi-Fi, BLE scan
Camera capture on ESP32-CAM class boards
Admin UI, serial shell, Telegram, simulator, browser lab
Chunked uploads, install-from-url, install-from-manifest
Tool-calling agent loop with runtime-visible logs

RUNTIME MAP

A simple stack with explicit primitives.

componentReusable driver or module

appInstallable feature bundle

taskLive execution now

behaviorPersisted task definition

eventDecoupled local signal

NEXT STEP

Start with the page that matches your intent.

Flash Grab the current release and install it from the browser. Browser Lab Use the real ESPClaw runtime in WebAssembly before touching hardware. Docs Understand the architecture, runtime primitives, and contribution model.