xiaozhi-esp32

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• ESP-IDF v6.0.1 或更高版本（推荐 v6.1，5.x 已不再支持）
• 一块受支持的 ESP32 系列开发板（如 ESP32-S3、ESP32-P4 等）
• 具备 Wi-Fi 或 4G 等网络环境（支持 Wi-Fi、有线以太网、USB RNDIS、ML307/EC801E/NT26 Cat.1 4G）
• 可访问 xiaozhi.me 官方控制台用于配置大模型

安装与启动步骤

1. 1克隆项目源码

   把 xiaozhi-esp32 源码拉到本地，后续用 ESP-IDF 编译。注意仓库是 C++ 固件工程，不是普通 PC 程序。

   git clone https://github.com/78/xiaozhi-esp32.git

   复制

2. 2安装 ESP-IDF

   按 README 要求安装 ESP-IDF v6.0.1 以上版本，推荐 v6.1；ESP-IDF 5.x 已不再支持，装错版本会编译失败。

3. 3编译烧录固件

   用 ESP-IDF 工具链针对你的开发板配置目标芯片并编译烧录。README 未给出具体命令，请以官方文档和板型说明为准。

4. 4配置大模型后台

   设备联网后登录 xiaozhi.me 控制台，为设备绑定并配置 Qwen / DeepSeek 等大模型，即可开始语音对话。

如何确认成功

设备成功连网并能被唤醒词唤醒，与官方服务正常语音对话，即说明部署成功。

常见问题

注意事项

• 这是嵌入式 C++ 固件项目，需要 ESP32 硬件和 ESP-IDF 开发环境，不能像普通软件那样直接在电脑上运行。
• README 未提供具体的编译、烧录命令和板型选择步骤，请以 ESP-IDF 官方文档及项目仓库内说明为准。
• ESP32-P4 Rev1 和 Rev3 在 IDF 6 下均受支持（ESP-SR 2.4.7）。
• 唤醒词基于 ESP-SR 离线语音唤醒，支持自定义。