从源码编译与烧录

操作流程

准备 ESP-IDF 环境

参考 ESP-IDF 安装指南，安装 ESP-IDF v5.5.4，并激活 ESP-IDF 环境。

激活 IDF 环境后，安装 ESP Board Manager 包：
```
pip install esp-bmgr-assist
```
ESP-Claw 使用 ESP Board Manager 适配多种开发版。
如需添加其他开发版，请参考 ESP Board Manager 文档。

获取 ESP-Claw 源码

git clone https://github.com/espressif/esp-claw.git
cd esp-claw/application/basic_demo

选择开发版
```
idf.py gen-bmgr-config -c ./boards -b <board_name>
# 例如: idf.py gen-bmgr-config -c ./boards -b esp32_S3_DevKitC_1
```
支持的开发版列表
你可以通过以下命令列出支持的开发版列表：
```
idf.py gen-bmgr-config -c ./boards -l
```
也可以在 application/basic_demo/boards 目录下查阅支持的开发版列表。
ESP Board Manager 会自动根据开发版选择合适的芯片型号，因此不需要 idf.py set-target。
调整 menuconfig 配置 可选
```
idf.py menuconfig
```
推荐修改以下配置：
- (Top) → Basic Demo Config
  - 参考配置说明配置基础设置。
- (Top) → Component config → ESP-Claw Core → Agent stage notification verbosity
  - 默认 Simple；
  - 若希望 Event Router 收到 agent_stage 事件（例如经 router_rules.json 把工具调用进度发到 IM），请选择 Verbose。
  - 详见数据流与自动化。
- (Top) → Component config → ESP System Settings
  - 配置 Channel for console output，使其与开发板硬件一致。
设备运行后，配置也可通过 NVS 持久化，运行时修改无需重新编译。详见配置说明。
编译与烧录
```
idf.py build
idf.py flash monitor
```