企业官网建设流程全解析

ESP-Claw从源码编译与烧录教程：本地构建固件完整步骤

【免费下载链接】esp-clawESP-Claw, a "Chat Coding" AI agent framework for IoT devices项目地址: https://gitcode.com/gh_mirrors/es/esp-claw

ESP-Claw 是乐鑫推出的面向物联网设备的「聊天造物」式 AI 智能体框架。本教程带你从源码本地构建 ESP-Claw 固件，并完整走通「环境配置 → 编译 → 烧录 → 监控」全流程，把固件烧录到你手边的 ESP32 开发板上。无需在线烧录工具，一条命令即可在本地复现官方固件。

准备工作：确认硬件与开发环境

在动手编译前，先确认两块东西：硬件与工具链。

硬件要求：ESP-Claw 需要至少8 MB Flash + 8 MB PSRAM，目前适配ESP32-S3、ESP32-P4等芯片。ESP32-S3 DevKitC 是最常见的入门选择。

工具链：安装ESP-IDF v5.5.4并激活环境（安装步骤具向下兼容性），然后在已激活的 IDF 环境中安装 Board Manager 辅助包：

pip install esp-bmgr-assist

💡 ESP-Claw 用ESP Board Manager自动适配各种开发板。若你要适配新板卡，适配文件存放在 application/edge_agent/boards/ 目录下。

第二步：克隆 ESP-Claw 源码

git clone https://gitcode.com/gh_mirrors/es/esp-claw cd esp-claw/application/edge_agent

固件工程位于application/edge_agent，后续的编译、烧录都在这条路径下进行。

第三步：选择开发板

用bmgr命令为你的开发板生成配置：

idf.py bmgr -c ./boards -b esp32_S3_DevKitC_1

想看看支持哪些板子？一条命令列出全部：

idf.py bmgr -c ./boards -l

也可直接浏览 application/edge_agent/boards/ 目录，找到对应厂商/型号。

📌为什么不用idf.py set-target？Board Manager 会根据所选开发板自动匹配芯片型号，省去手动设置 target 的麻烦。

第四步：调整 menuconfig 配置（可选）

idf.py menuconfig

新手可按默认值直接跳过。若需要自定义，推荐关注这几项：

• App Claw Config：配置基础参数（Wi-Fi、LLM 等）
• Component config → ESP-Claw Core → Agent stage notification verbosity：默认Simple，若希望 Event Router 收到agent_stage事件则选Verbose
• ESP System Settings → Channel for console output：按开发板硬件设置控制台输出通道

📝 设备运行后配置还会通过 NVS 持久化，运行时修改无需重新编译，详见 配置说明。

第五步：编译与烧录固件

idf.py build idf.py flash monitor

idf.py build会先复制基线 FATFS 系统镜像、再叠加所选开发板的专属文件，最终打包出完整固件；idf.py flash monitor一键完成烧录并打开串口监控。烧录完成后设备自动重启，即可进入 Wi-Fi 与参数配置页面。

烧录后：连接与配置

设备重启后，通过数据线标记UART的 USB 口连接电脑，即可进入 Web 配置页面：填写 Wi-Fi、选择 LLM（GPT / Qwen / Claude / DeepSeek）、配置聊天软件（Telegram / QQ / 飞书 / 微信）与搜索引擎，即可开始体验。完整在线体验流程可参考 快速开始。

常见问题

• 编译报版本错误？请确认已激活的是ESP-IDF v5.5.4环境，并已执行pip install esp-bmgr-assist。
• 找不到我的开发板？说明该板尚未适配，可到 application/edge_agent/boards/ 对照厂商目录，或通过 Pull Request 贡献板卡适配。
• 只想快速体验？已有开发板可改用在线烧录，无需本地编译。

下一步

本教程的完整步骤与更多开发者细节，见官方文档 从源码编译与烧录 与 Edge Agent 工程说明。掌握编译烧录后，你可以继续深入 项目架构总览，开始裁剪模块、扩展自己的组件能力。

【免费下载链接】esp-clawESP-Claw, a "Chat Coding" AI agent framework for IoT devices项目地址: https://gitcode.com/gh_mirrors/es/esp-claw