5.2 源码烧录

1. 准备 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 文档， 将开发板适配文件存放到 application/edge_agent/boards

2. 获取 ESP-Claw 源码

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

cd esp-claw/application/edge_agent

3. 选择开发板

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/edge_agent/boards 目录下查阅当前支持的开发板列表。

为什么不需要 set-target

ESP Board Manager 会自动根据开发板选择合适的芯片型号，因此不需要 idf.py set-target。

4. menuconfig 配置

idf.py menuconfig

信息

更详细的配置方法，请参考 配置说明

推荐修改以下配置：

(Top) → App Claw 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 持久化，运行时修改无需重新编译。详见 配置说明

5. 编译与烧录

idf.py build
idf.py flash monitor

注意

烧录完成后，可以参考 5.3 Web配置 来配置 Wi-Fi、LLM、IM、搜索 等参数。