ESPClaw Runtime for boards with real hardware GitHub

ESPCLAW // BRING THE AGENT CLOSER TO THE HARDWARE

Put a programmable runtime at the hardware boundary, 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