跳到主要内容

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/basic_demo/boards

欢迎将开发板适配代码通过 Pull Request 提交到 ESP-Claw 仓库。

2. 获取 ESP-Claw 源码​

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

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

为什么不需要 set-target

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

4. menuconfig 配置​

idf.py menuconfig

推荐修改以下配置：

  • (Top) → Basic Demo Config

    配置基础设置

    • Default WI-FI Settings 用于配置WiFi名和密码。

    • Default LLM Settings 用于配置 LLM 模型。

    • Default IM Settings 用于配置聊天软件。

    • Default Search Settings 用于配置搜索引擎。

    esp-claw-5

  • (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，使其与开发板硬件一致。

5. 编译与烧录​

idf.py build
idf.py flash monitor