ESP-Claw: IoT 장치를 위한 대화형 코딩 AI 에이전트 프레임워크

ESP-Claw는 Espressif의 Chat Coding AI 에이전트 프레임워크로, 사물인터넷(IoT) 기기를 위해 설계되었습니다. 이 프레임워크는 대화를 통해 장치 동작을 정의하고, 감지(sensing), 의사결정(decision-making), 실행(execution)의 전체 루프를 Espressif 칩에서 로컬로 완료합니다. OpenClaw 개념에서 영감을 받아 C 언어로 재구현된 ESP-Claw는 가볍고 지능적이며 지속적으로 진화하고 있습니다. 단 몇 달러밖에 하지 않는 ESP32 시리즈 칩만으로도 ESP-Claw가 얼마나 민첩한지 경험할 수 있습니다.

전통적인 IoT는 보통 연결성에서 멈춥니다. 즉, 장치는 네트워크에 연결할 수는 있지만 생각할 수는 없고, 명령을 실행할 수는 있지만 결정을 내릴 수는 없습니다. ESP-Claw는 Agent Runtime을 Espressif 칩으로 가져와, 이들을 수동적인 실행기(passive executors)가 아닌 능동적인 의사결정 센터로 변화시킵니다.

💬 대화를 통한 생성 (Chat as Creation)
⚙️ 이벤트 기반 (Event Driven)
|---|---|
| IM 채팅 + 동적 Lua 로딩 | 일반 사용자는 프로그래밍 없이 장치 동작을 정의할 수 있습니다 |
| 모든 이벤트가 Agent Loop를 트리거하고 그 이상을 수행합니다 | 응답 속도가 밀리초(milliseconds)만큼 빠를 수 있습니다 |

chat-coding-en.webm |

event-en.webm |

🧬 구조화된 메모리 (Structured Memory)
📤 MCP 통신 (MCP Communication)
|---|---|
| 기억을 구조적인 방식으로 정리합니다 | 개인 정보는 클라우드를 벗어납니다 |
| 표준 MCP 장치를 지원합니다 | 서버와 클라이언트 역할을 모두 수행할 수 있습니다 |

memory-en.webm |

mcp-en.webm |

🧰 즉시 사용 가능 (Ready Out of the Box)
🧩 컴포넌트 확장성 (Component Extensibility)
|---|---|
| 보드 매니저(Board Manager)로 빠르게 설정할 수 있습니다 | 원클릭 플래싱을 지원합니다 |
| 모든 모듈은 필요에 따라 간소화(trimmed)될 수 있습니다 | 자체 컴포넌트 통합도 추가할 수 있습니다 |

ESP-Claw는 이제 ESP32-S3, ESP32-P4, ESP32-C5, 그리고 ESP32-S31을 기반으로 하는 광범위한 개발 보드(breadboards, M5Stack CoreS3 등 다수 포함)를 지원합니다. 지원되는 보드는 ./application/edge_agent/boards/에 있습니다.

온라인에서 직접 플래싱할 수 있으며, 설정과 플래싱이 모두 브라우저 내에서 이루어지므로 로컬에서 펌웨어를 컴파일하거나 개발 환경을 먼저 설치할 필요가 없습니다.

ESP-Claw를 로컬에서도 구축할 수 있습니다. 보드 적응(board adaptation), 빌드 및 플래싱에 대해서는 로컬 빌드 문서를 참조해 주십시오. 위에 나열되지 않은 보드는 물론, ESP32-P4와 같은 칩도 로컬 빌드 및 플래싱을 통해 지원될 수 있습니다.

실용적인 예제는 저희 문서에서 찾으실 수 있습니다.

Supported Platforms

LLM: ESP-Claw는 이제 OpenAI 스타일 API와 Anthropic 스타일 API를 모두 지원합니다. OpenAI의 GPT 모델, Alibaba Cloud Bailian의 Qwen 모델, Anthropic의 Claude 모델, DeepSeek API의 DeepSeek 모델을 네이티브로 지원하며, 사용자 정의 엔드포인트도 지원합니다.

팁

ESP-Claw의 자체 프로그래밍 기능은 강력한 도구 사용(tool use) 및 지침 준수 능력(instruction-following ability)을 가진 모델에 따라 달라집니다. gpt-5.4, qwen3.6-plus, claude4.6-sonnet, deepseek-v4-pro 또는 이와 유사한 능력을 가진 모델을 권장합니다.

IM: ESP-Claw는 Telegram, QQ, Feishu, WeChat를 지원하며, 추가적인 확장이 가능합니다.

ESP-Claw는 현재 활발하게 개발 중입니다. 문제점을 보고하거나 기능을 요청하려면 언제든지 이슈(issue)를 열어주십시오. 또한 온라인 설문조사(중국어)를 통해 아이디어를 공유할 수도 있습니다.

TODO 목록(중국어)을 보려면 여기를 클릭하고, 중요하다고 생각하는 기능이나 이슈에 투표해 주십시오. 이는 저희가 해당 사항들을 더 빨리 우선순위화하는 데 도움이 됩니다.

ESP-Claw는 현재 Espressif Bug Bounty Program에 포함되어 있지 않습니다. 책임감 있는 취약점 보고(Responsible vulnerability reports)는 여전히 매우 중요하게 평가되지만, 이 정책 하에서는 금전적 보상이 약속되거나 보장되지 않습니다.

이 프로젝트가 도움이 되었다면 별점을 주시는 것을 고려해 주십시오. ⭐⭐⭐⭐⭐

OpenClaw에서 영감을 받았습니다.

Agent Loop, IM 통신 및 관련 기능의 ESP32 구현은 MimiClaw에서도 차용했습니다.