ESP-PPQ를 통한 ONNX→.espdl 양자화 경로를 제공하는, Espressif ESP 시리즈 칩에서 AI 모델을 실행하기 위한 경량 신경망 추론 프레임워크입니다.
memovai/mimiclaw
5달러짜리 ESP32-S3 칩에서 실행되며 Telegram으로 대화하는 순수 C 기반 개인용 AI 어시스턴트 펌웨어입니다.
- 스타
- 5,802
- 포크
- 894
- 열린 이슈
- 111
- 마지막 커밋
- 18일 전
어떤 프로젝트인가요?
MimiClaw는 소형 ESP32-S3 개발 보드를 개인용 AI 어시스턴트로 바꿔 주는 펌웨어입니다. 기기는 WiFi에 연결해 Telegram 봇을 통해 메시지를 받습니다. 각 메시지는 에이전트 루프로 전달되며, 이 루프에서 LLM은 도구를 호출하고 저장된 메모리를 읽은 뒤 답장을 보낼 수 있습니다. Anthropic(Claude)과 OpenAI(GPT)를 모델 공급자로 지원하며, 시리얼 콘솔에서 실행 중에도 공급자를 전환할 수 있습니다.
이 프로젝트는 Linux, Node.js, 서버 없이 실행됩니다. 메모리, 채팅 기록, 설정은 SOUL.md, USER.md, MEMORY.md 같은 일반 텍스트 파일로 보드의 플래시에 저장되므로 직접 읽고 수정할 수 있습니다. 펌웨어에는 AI가 반복 작업이나 일회성 작업을 만들 수 있는 cron 스케줄러와, HEARTBEAT.md를 주기적으로 확인해 미완료 항목을 처리하는 heartbeat 서비스가 포함되어 있습니다.
그 밖에도 로컬 네트워크의 WebSocket 게이트웨이, WiFi를 통한 OTA 펌웨어 업데이트, HTTP CONNECT 프록시 옵션, Tavily 또는 Brave API 키를 이용한 웹 검색 기능이 내장되어 있습니다. 빌드에는 ESP-IDF v5.5 이상을 사용하며, Ubuntu와 macOS용 설정 스크립트도 제공됩니다.
핵심 기능
- 01Linux나 Node.js 없이 ESP32-S3 보드에서 실행
- 02Telegram 봇을 통해 어시스턴트와 대화
- 03Anthropic 및 OpenAI 모델 지원, 실행 중 전환 가능
- 04메모리, 성격, 채팅 기록을 플래시에 수정 가능한 텍스트 파일로 저장
- 05cron과 heartbeat 파일을 통한 예약 및 주기적 작업
- 06Tavily 또는 Brave API 키를 이용한 웹 검색
활용 사례
- 여분의 마이크로컨트롤러 보드에서 저전력으로 상시 실행되는 개인용 어시스턴트 구축
- 임베디드 하드웨어에서 LLM 에이전트 실험
- Telegram으로 예약 알림이나 일일 요약 받기
- 최소한의 ReAct 스타일 에이전트 루프를 C로 구현하는 방법 학습
빠른 시작
- 1
먼저 ESP-IDF v5.5 이상을 설치하세요(공식 ESP-IDF 가이드 참조).
- 2
저장소를 클론하세요.
git clone https://github.com/memovai/mimiclaw.git - 3
프로젝트 폴더로 이동한 다음 타깃을 ESP32-S3로 설정하세요.
cd mimiclaw && idf.py set-target esp32s3 - 4
secrets 템플릿을 복사하고 WiFi, Telegram 토큰, API 키를 입력한 뒤 USB(JTAG) 포트를 통해 빌드하고 플래시하세요.
idf.py fullclean && idf.py build
사용 전 알아둘 점
- 플래시 16 MB와 PSRAM 8 MB를 갖춘 ESP32-S3 보드와 유료 LLM API 키(Anthropic 또는 OpenAI)가 필요합니다.
- 설정에는 ESP-IDF v5.5 이상이 필요하며 펌웨어를 빌드하고 플래시해야 하므로 간단한 설치 방식이 아닙니다.
- Telegram으로 채팅하므로 Telegram 봇과 WiFi 연결이 필요합니다.
토픽
자주 묻는 질문
- mimiclaw은(는) 무엇인가요?
- 5달러짜리 ESP32-S3 칩에서 실행되며 Telegram으로 대화하는 순수 C 기반 개인용 AI 어시스턴트 펌웨어입니다. MimiClaw는 소형 ESP32-S3 개발 보드를 개인용 AI 어시스턴트로 바꿔 주는 펌웨어입니다. 기기는 WiFi에 연결해 Telegram 봇을 통해 메시지를 받습니다. 각 메시지는 에이전트 루프로 전달되며, 이 루프에서 LLM은 도구를 호출하고 저장된 메모리를 읽은 뒤 답장을 보낼 수 있습니다. Anthropic(Claude)과 OpenAI(GPT)를 모델 공급자로 지원하며, 시리얼 콘솔에서 실행 중에도 공급자를 전환할 수 있습니다.
- mimiclaw은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- mimiclaw은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- mimiclaw은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. mimiclaw의 마지막 커밋은 2026년 10월 4일입니다.
- mimiclaw은(는) 어디에 사용할 수 있나요?
- 여분의 마이크로컨트롤러 보드에서 저전력으로 상시 실행되는 개인용 어시스턴트 구축 임베디드 하드웨어에서 LLM 에이전트 실험 Telegram으로 예약 알림이나 일일 요약 받기 최소한의 ReAct 스타일 에이전트 루프를 C로 구현하는 방법 학습
- mimiclaw는 어떻게 설치하나요?
- 먼저 ESP-IDF v5.5 이상을 설치하세요(공식 ESP-IDF 가이드 참조). 저장소를 클론하세요.: git clone https://github.com/memovai/mimiclaw.git 프로젝트 폴더로 이동한 다음 타깃을 ESP32-S3로 설정하세요.: cd mimiclaw && idf.py set-target esp32s3 secrets 템플릿을 복사하고 WiFi, Telegram 토큰, API 키를 입력한 뒤 USB(JTAG) 포트를 통해 빌드하고 플래시하세요.: idf.py fullclean && idf.py build
- mimiclaw은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/memovai/mimiclaw
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
2D/3D 그래픽, 입력, 오디오와 크로스 플랫폼 지원을 제공하고 외부 의존성이 없는 간단한 게임 개발용 C 라이브러리입니다.
ESP32를 카메라나 마이크 없이 Wi-Fi 신호 변화로 움직임을 감지하는 비공개 로컬 Wi-Fi 모션 센서로 만듭니다.
ESP32 기반의 오픈소스 3D 프린팅 미니 사족보행 로봇으로, OLED 얼굴과 서보 모터 구동 보행 기능을 갖췄습니다.
ESP32 보드와 Raspberry Pi 같은 Linux 기기에서 Muse 가젯을 만드는 오픈소스 SDK와 펌웨어입니다.
Claude Code 사용 한도를 표시하고, 프롬프트에 반응하는 애니메이션 마스코트와 세션 입력 알림을 제공하는 ESP32 데스크 디스플레이입니다.