Release Note - ESP-Claw v0.1.0

The first release of ESP-Claw. Thanks to all contributors for their code, board support, and feedback that helped shape this release.

Tip

For build and usage instructions, please refer to the documentation at https://esp-claw.com/

Architecture diagram (Click here to expand)

Agent Core

Supports Agent Loop with multiple API providers and tool-calling capabilities.
Supports Multi-Agent execution with real-time Sub-Agent progress tracking.
Supports context management:
- Builds context-appropriate prompts on demand;
- Optimizes prefix consistency to improve cache hit rate;
- Allows retaining recent Tool Call history with automatic future cleanup, improving continuity on complex tasks;
- Supports automatic context compression.
Supports context and working state recovery after abnormal Agent Loop exits.
Supports session interruption and session switching.
Reduced memory footprint.

Lua Runtime

Supports synchronous Lua script execution.
Supports asynchronous Lua script execution:
- New lua_tail_async_job and lua_get_async_job APIs for async execution;
- Supports log persistence during async execution: print() output is automatically saved to file for easier debugging;
- New Thread mechanism for inter-Lua-thread communication, supporting both Queue and Semaphore modes.
New Lua Module structure combining README, Skills, Tests, and src to improve LLM comprehension of module functionality.
Improved Lua Runtime stability.

Applications

`edge_agent`

Supports 20+ development boards via Board Manager and community contributions, covering ESP32-S3 / ESP32-C5 / ESP32-P4 / ESP32-S3.
Supports Web Config for online configuration adjustments and filesystem read/write.

`mcp_server_point`

Add mcp_server_point application.

Extension Components & Skills

Skills Lab for sharing, searching, and installing Skills, making them easier to use.
Supports LVGL graphical UI capabilities — draw UI from Lua using LVGL, with touch input handling in Lua.
Supports a wide range of peripheral components:
- Direct access to I2C, UART, MCPWM, PCNT, RMT, ADC, USB, BLE HID, and other peripherals from Lua¹;
- Supports USB Camera (UVC) and USB microphone/speaker (UAC), callable from Lua and other contexts, with improved runtime stability.

Miscellaneous

Supports HTTP connection reuse to reduce latency.
Supports PSRAM-backed virtual filesystem (RAMfs) to reduce Flash I/O latency and Flash wear.
Supports automatic recovery of critical files on partition failure, preventing Boot Loops caused by filesystem corruption.
Supports ESP-IDF v5.5.4 and v6, compatible with the latest IDF framework versions.

Web & Documentation

Supports online flashing and configuration workflow.
Improved system architecture documentation.

PRs in this release

fix(cap_im_qq): fix qq send file by @2002-luzi in #3
boards: add M5Stack CoreS3 board support by @imliubo in #5
add dfrobot k10 by @wxzed in #28
boards: add LilyGO T-Display-S3 board support by @terry-cook in #14
fix(anthropic): preserve thinking blocks and merge consecutive tool r… by @zz6zz666 in #40
新增无名科技xingzhi-395开发板支持 by @vaemc in #55
fix(llm): 净化 LLM 请求体中的损坏 UTF-8 避免 HTTP 400 by @yuzheyi in #58
feat(board): 新增微雪 ESP32-P4-NANO 开发板 BSP 支持 by @yuzheyi in #59
feat(board): add Movecall board configurations by @MoveCall in #50
Enable SCI sensor access from Lua by @rockets-cn in #32
feat: add configurable AP name and password to Wi-Fi settings by @Karasukaigan in #63
feat: add board M5Stack Tab5 by @TinyuZhao in #71
feat: add allowlisted http_request capability by @CSY-tvgo in #64
Add support for Waveshare ESP32-S3-RLCD-4.2 (Reopened for #45) by @CSY-tvgo in #65
feat: let waveshare_ESP32_S3_RLCD_4_2 support web flash by @CSY-tvgo in #81
feat: add QQ message type selector (Plain Text / Markdown) in IM sett… by @Karasukaigan in #99
feat: add board DFRobot ai camera by @tangjie133 in #106
feat(board): add ESP32-S3 SparkBot board configuration by @ymzhang0319 in #76
boards: Add support for Waveshare ESP32-S3-GEEK board by @mogenson in #67
feat: Add lilygo_t_display_p4 board support by @Llgok in #56
boards: Add Rockbase iot NM-CYD-C5 by @RockBase-iot in #116
feat: add dfrobot board firebeetle2_esp32_s3 by @tangjie133 in #109
fix(wifi): support open STA network and improve diagnostics by @leeebo in #117
fix: keep stage and subagent text on UTF-8 character boundaries by @BigUncleUs in #121