小智 ESP32 语音助手快速上手指南三步做出你自己的 AI 语音助手【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32凌晨两点你准备睡觉说了句小智关灯灯真的灭了不用摸黑去翻手机。开源项目 xiaozhi-esp32 把一个 ESP32 语音助手做成了会聊天、能被唤醒、还能控制硬件的 AI 语音助手它接入通义千问、DeepSeek 这类大模型靠 MCP 协议让设备听懂把灯关了并真正执行。这篇指南从原理讲到烧录走一遍完整的上手路线。它凭什么听懂你一条完整的语音链路ESP32 语音助手内部跑的是听—懂—答的闭环拆开看是四步麦克风拾音板载音频编解码芯片把声音变成数字信号整条音频流水线由 main/audio/ 管理芯片内的音频前端AFE可以理解为给声音做清洁和定位的车间负责降噪、回声消除基于 ESP-SR 的唤醒词模型则逐帧判断有没有人喊小智唤醒之后你的语音被 Opus 压缩成 16 kHz 单声道流通过 WebSocket 或 MQTTUDP 上传云端依次经过语音识别、大模型理解、语音合成回复的语音流下发解码后进扬声器播出。理解控制这一环的关键是 MCP 协议——你可以把它看成一套标准工具箱交接约定设备先把自己拥有的工具灯、扬声器、GPIO、舵机上报给云端大模型听到关灯就按名字调用对应工具设备收到后立刻执行。最快上手路径开发板怎么选三句话说明白纯学习立创 ESP32-S3 或 AtomS3R Echo Base 就够小巧便宜足够体验唤醒和对话做家里常开的演示M5Stack CoreS3 和 ESP32-S3-BOX-3 更实用16MB Flash、带屏带按键直接能当 ESP32 智能家居开发的入口要便携低功耗看 ESP32-C3 系列。仓库已内置 138 个板级目录、171 个编译变体多数开发板不用自己写驱动。环境准备用 Cursor 或 VSCode 加 ESP-IDF 插件即可推荐 ESP-IDF v6.0.2主线已切到 v6 系列v5.5 只保留给个别老板卡Linux 下编译和驱动都更省心。三分钟完成固件烧录git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32 cd xiaozhi-esp32 idf.py set-target esp32s3接着运行idf.py menuconfig在 Board Type 里选中你的板卡然后idf.py build idf.py -p /dev/ttyUSB0 flash monitor盯着串口输出设备启动后完成 Wi-Fi 配网第一次唤醒就能对话了。完全不想搭开发环境也没关系项目提供免配置环境的现成固件默认连 xiaozhi.me 官方服务器个人用户注册后即可免费使用通义千问实时模型。按你的想法改唤醒词怎么换。默认唤醒词是小智两条路在 menuconfig 里选 ESP-SR 支持的其它唤醒词或用自定义素材能力生成自己的唤醒词模型、字体、表情打包进 assets.bin 烧录想改实现细节看 main/audio/wake_words/ 目录就行。AI 服务怎么切。设备连上官方服务器后在控制台就能切换通义千问、DeepSeek 等模型想自建后端也有 Python / Java / Go 的服务端可选。设备侧支持 WebSocket 与 MQTTUDP 两种传输协议细节见 docs/websocket.md 和 docs/mqtt-udp.md。智能家居和教育陪伴怎么玩。智能家居不需要什么魔法把硬件注册成设备端 MCP 工具大模型就能按名字调用完整流程在 docs/mcp-usage.md。做儿童陪伴仓库已内置 38 种界面语言和本地化语音提示音频在 main/assets/locales/ 下改默认语言只需一步 menuconfig。仓库还带现成的音频处理脚本比如 scripts/p3_tools/ 下的批量转换工具卡住了看这里烧录后设备没反应多数是板型不匹配。确认芯片后重新执行idf.py set-targetmenuconfig 里重选 Board Type再idf.py fullclean重编一次。Wi-Fi 连上了但没有声音看串口里服务器地址与设备激活是否走完自建板还要核对音频编解码器的引脚配置麦克风接线反了是最高频原因。唤醒词怎么喊都没反应先在串口确认唤醒词模型是否加载成功再排除环境噪音过大最后检查麦克风增益与 AEC 配置。连不上 Wi-Fi核对密码与信号强度想改用蓝牙下发密码可看 docs/blufi_zh.md 里 BluFi 配网的开启方式。xiaozhi-esp32 把一个语音助手从演示品做成了能自己搭的东西硬件链路、协议层、模型配置各归其位你只需要补上缺的那一块。接下来值得深入的方向有三个照着 docs/custom-board.md 把自己手头的板子做成一个新变体扩展云端 MCP接入天气、知识检索、邮件这类能力如果你的板子硬件支持回声消除打开实时全双工交互让设备在你说话中途也能被打断。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考