Skip to content

m5stack/ESP-Claw

 
 

Repository files navigation

ESP-Claw logo

ESP-Claw 🦞 AI Agent Framework for IoT Devices

💬 Chat as Creation · 🚀 Millisecond Response · 🧩 Smart and Extensible · 😋 Grows with You

Runs on ESP32 Series License

Home | Docs | Online Flashing | Build from Source | 简体中文

ESP-Claw is Espressif's Chat Coding AI agent framework for IoT devices. It defines device behavior through conversation and completes the full loop of sensing, decision-making, and execution locally on Espressif chips. Inspired by the OpenClaw concept and reimplemented in C, ESP-Claw is lightweight, intelligent, and continuously evolving. With just an ESP32-series chip that costs only a few dollars, you can experience what makes ESP-Claw so nimble.

From traditional IoT to Edge Agent

🌟 Key Features

Traditional IoT usually stops at connectivity: devices can connect to the network, but they cannot think; they can execute commands, but they cannot make decisions. ESP-Claw brings the Agent Runtime down onto Espressif chips, turning them from passive executors into active decision-making centers.

💬 Chat as Creation
⚙️ Event Driven
IM chat + dynamic Lua loading
Ordinary users can define device behavior without programming
Any event can trigger the Agent Loop and more
Response can be as fast as milliseconds
chat-coding-en.webm
event-en.webm
🧬 Structured Memory
📤 MCP Communication
Organize memories in a structured way
Privacy stays off the cloud
Supports standard MCP devices
Works as both Server and Client
memory-en.webm
mcp-en.webm
🧰 Ready Out of the Box
🧩 Component Extensibility
Quick setup with Board Manager
Supports one-click flashing
Every module can be trimmed as needed
You can also add your own component integrations

📦 Quick Start

ESP-Claw on ESP32-S3 Breadboard

ESP-Claw already supports multiple ESP32-S3-based development boards, including breadboards, M5Stack CoreS3, and more. Supported boards in ./application/edge_agent/boards/ can be flashed online directly: configuration and flashing are done entirely in the browser, with no need to compile firmware locally or install a development environment first.

You can also build ESP-Claw locally. Please refer to the local build documentation for board adaptation, building, and flashing. Boards not listed above, as well as chips like the ESP32-P4, can also be supported through local builds and flashing.

You can find practical examples in our documentation.

Supported Platforms

Supported Platforms

LLM: ESP-Claw now supports both OpenAI-style APIs and Anthropic-style APIs. It natively supports GPT models from OpenAI, Qwen models from Alibaba Cloud Bailian, Claude models from Anthropic, DeepSeek models from DeepSeek API, and also supports custom endpoints.

Tip

ESP-Claw's self-programming capability depends on models with strong tool use and instruction-following ability. We recommend gpt-5.4, qwen3.6-plus, claude4.6-sonnet, deepseek-v4-pro or models with comparable capability.

IM: ESP-Claw supports Telegram, QQ, Feishu, and WeChat, and can be extended further.

Note

This project is still under active development. If you run into any issues, feel free to open an issue.

📷 Follow Us

If this project helps you, please consider giving it a star. ⭐⭐⭐⭐⭐

Star History

Acknowledgements

Inspired by OpenClaw.

The implementation of Agent Loop, IM communication, and related capabilities on ESP32 also draws on MimiClaw.

About

ESP-Claw, a "Chat Coding" AI agent framework for M5Stack devices

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • C 84.9%
  • JavaScript 4.0%
  • Lua 3.3%
  • Python 2.8%
  • HTML 2.0%
  • CMake 1.6%
  • CSS 1.4%