如何把 ESP32 变成 AI 语音助手xiaozhi-esp32 完整指南【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32xiaozhi-esp32 是一个基于 MCP 协议的 ESP32 语音聊天机器人固件烧录后对它喊一句唤醒词它就能听你说话、回答问题和控制灯光。本文适合没碰过嵌入式的硬件新手和学生讲清买什么板子、怎么烧录、跑通后能玩什么。 这是个什么东西MCPModel Context Protocol是一套让云端大模型调用工具的统一协议通俗点说大模型在云里思考ESP32 在本地干活。xiaozhi-esp32 把这两端用同一套协议接起来就像家里请了个传话员——你在设备端说调大音量传话员转达给大模型大模型再发指令让 ESP32 真的拧大音量旋钮。你不需要为每种硬件单独写 AI 接入逻辑。 烧录后到底能干啥语音链路离线唤醒基于 ESP-SR 在本地识别你好小智支持自定义唤醒词断网也能喊醒流式对话Opus 音频流 流式识别 大模型 语音合成也支持端到端实时语音模型全双工交互带回声消除AEC的硬件可以边听边说不用按住按键声纹识别能认出当前是谁在说话硬件控制通过设备端 MCP大模型直接操作本地外设音量、LED、舵机、GPIO 等显示与体验OLED / LCD 屏幕显示表情和情绪状态部分板卡还有摄像头视觉输入38 种界面语言语音提示优先用本地化资源缺失时回退英文 硬件怎么选项目目前支持 138 个板卡目录、171 个固件发布变体覆盖 ESP32、ESP32-C3、ESP32-C5、ESP32-C6、ESP32-S3、ESP32-P4 六个芯片平台。最省钱起步面包板 一块 ESP32-C3 或经典 ESP32NodeMCU 32S 这类就行再配 I2S 麦克风、喇叭和按键参考 README_zh.md 里的面包板章节接线。开箱即用乐鑫 ESP32-S3-BOX-3 或 M5Stack CoreS3带屏幕、电池、麦克风阵列插电烧录就能用。进阶体验Waveshare ESP32-S3-Touch-AMOLED-1.8、LILYGO T-Circle-S3 这类带触摸屏的板子或 SenseCAP Watcher 这类带摄像头的成品体验更完整。 固件怎么烧新手路径不必先搭开发环境直接下载免开发环境的现成固件用烧录工具刷进去即可。固件默认接入 xiaozhi.me 官方服务器注册账号后个人可免费使用 Qwen 实时模型。源码路径建议 Linux用 VSCode 或 Cursor 装 ESP-IDF 插件SDK 需 v6.0.1 及以上推荐 v6.1已不再支持 5.xgit clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32 cd xiaozhi-esp32 idf.py menuconfig # 选板型与参数 idf.py build⏱ 跑通需要几步烧录固件新手走现成固件开发者走上面源码路径开机后手机连上设备发出的 Wi-Fi 热点输入你家 Wi-Fi 密码完成配网配网就是让设备连上你家里网络的过程在 xiaozhi.me 注册账号把设备绑定并激活对着设备喊你好小智听到提示音说明唤醒成功说一句话验证它语音回答说把音量调到 50验证 MCP 设备端控制生效 不对劲先查哪里连不上 Wi-Fi→ 用热点配网重试设备支持 BluFi 时再用蓝牙配网核对 SSID 和密码唤醒词没反应→ 先查麦克风的接线和供电供电不稳时唤醒成功率会明显下降编译失败或报版本错误→ 确认 ESP-IDF 是 v6.0.1 及以上5.x 已不支持旧版板卡看 docs/custom-board_zh.md 的说明对话有延迟或断流→ 换近距离 Wi-Fi 环境重试确认设备到服务器网络通畅 接下来可以玩什么打开 docs/mcp-usage_zh.md把音量之外的设备端工具舵机、GPIO、传感器挂给大模型调用想加一块新开发板就按 docs/custom-board_zh.md 写板卡配置文件想自建服务而不是接官方服务器README_zh 里列了可供自建的第三方开源服务器项目挑一个部署即可。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考