3步把ESP32变成AI语音助手xiaozhi-esp32上手指南【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32面包板通电对着麦克风喊一声你好小智板子抬起头听你说扬声器里回了一句人话——这就是 xiaozhi-esp32 烧录完成后的样子。它是一套开源的 AI语音助手 固件把支持列表里的 ESP32 开发板变成能离线唤醒、能流式对话、还能通过 MCP 协议控制外设的语音交互入口背后接的是 Qwen、DeepSeek 这类大模型。图面包板方案完整接线图中标注了适用的开发板型号NodeMcu32s / Devkit C / ESP32-D0LD / GoouuuESP32和注意事项30秒速览值不值得读下去xiaozhi-esp32 一句话定义给 ESP32 装上耳朵、嘴和脑子的开源固件语音交互 MCP 多端控制。维度情况硬件门槛一块 ESP32 开发板 麦克风 喇叭即可官方已适配 138 个板卡目录、171 个固件变体上手时间新手用现成固件镜像烧录 配网约 10 分钟自建编译环境另需安装 ESP-IDF v6.0.2通信方式WebSocket 和 MQTT UDP 两种音频走 Opus 流扩展方式设备端 MCP 控制本地硬件音量、灯光、GPIO云端 MCP 扩展智能家居、知识搜索等能力5分钟烧录第一个AI语音助手获取代码自建固件才需要git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32新手建议跳过自建环境直接用官方免开发环境固件镜像。选硬件配置你的板子在 main/boards/ 下有对应目录menuconfig 里选对应选项即可配置和引脚都已在目录里写死。烧录并配网固件默认接入 xiaozhi.me 官方服务器个人注册账号可免费使用 Qwen 实时模型。首次启动按提示用手机热点或 BluFi 把 Wi-Fi 配给设备。开始交互说出唤醒词你好小智进入对话有显示屏的板子还会同步显示表情。图README 中展示的面包板成品效果含 4G 模组与显示屏可作为焊接/插线参照原理速读MCP 怎么把云端和硬件接起来MCPModel Context Protocol模型上下文协议可以理解成一个统一插座标准云端大模型负责思考和决策但拧哪个开关、调多大音量这些动作交给设备端去执行。图左侧是设备端 MCP 控制喇叭、LED、舵机、GPIO 等本地硬件右侧是云端 MCP 对接 Home Assistant、知识搜索、邮件等扩展能力好处是双向的设备端用同一套协议控制本地硬件云端用同一套协议扩展能力你以后加新工具不用改通信层。音频链路走的是流式麦克风采样 → 本地离线唤醒基于 ESP-SR不联网也能喊醒保护隐私→ Opus 编码上云做流式识别 → 大模型生成 → TTS 语音流边生成边播。带 AEC回声消除的硬件还能做到边说边听的实时全双工。能玩出什么花样自定义唤醒词不喜欢你好小智menuconfig 里选自定义唤醒词类型训练一个自己的专属短语设备就叫你的名字。桌面学习搭子放在书桌上查资料、翻译、练口语界面支持 38 种语言语音提示缺本地资源时自动回退英文。语音控设备通过 MCP 工具让它操作 GPIO、舵机、灯光——仓库里的机器人板卡如 otto-robot就是说话 动腿的完整例子。改造入口想动手改哪里加一块新板子在main/boards/下建目录写一个 config.json 加驱动文件照着 docs/custom-board_zh.md 走效果是 menuconfig 里多一个你的板型。加一个新工具改 main/mcp_server.cc注册一个 MCP 工具比如控制 RGB 灯效果是云端模型直接能用语音调它。换音色和表情改 main/assets/locales/ 下的 ogg 语音包或参考 main/display/ 添加表情资源效果是唤醒提示音、界面风格全变。避坑与答疑Q面包板版本支持我的 ESP32-C3 / S3 吗不支持。面包板目录明确标注非 C3、非 S3适用 NodeMcu32s、Devkit C、ESP32-D0LD、GoouuuESP32 这类标准 ESP32/S2。有屏幕和 4G 的进阶接线可看 docs/v1/wiring2.jpg。Q上电就重启、时断时续九成是供电。面包板用 USB 5V 直供别从 3.3V 引出取电扬声器瞬态电流很大。Q喊唤醒词没反应先确认板子烧的是不是带唤醒模型的固件menuconfig 中 WAKE_WORD 选项再查麦克风接线和供电不要在没解决硬件问题前调灵敏度参数。Q语音识别经常听错安静环境测试基线麦克风靠近声源仓库提供 scripts/audio_debug_server.py 可把设备音频导到 PC 端排查。Q电池供电发热掉电快多数板卡带电源管理见各板目录的 power_manager.h支持深度睡眠长期无人交互场景让它睡得更久即可具体参数以板卡配置为准。文档与下一步进阶内容都在仓库 docs/ 里MCP 交互流程、MQTT UDP 协议、WebSocket 协议、自定义开发板指南大模型配置说明见 README_zh.md。挑一块手头的 ESP32先按5分钟烧录那节的四步走通第一次对话再决定往哪个方向改——动手比通读源码学得快。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考