一句话就有回应xiaozhi-esp32 之 ESP32 AI语音助手完整教程【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32深夜想关灯又不想起身。你不用伸手去够遥控器只要说一句关灯摆在房间角落的那台小设备就会照办——这不是你买的智能音箱而是用一块 ESP32 开发板自己搭出来的 xiaozhi-esp32一个把ESP32 AI语音助手跑在你桌面上的开源项目。一分钟认识 xiaozhi-esp32一句话定位它是个基于 MCP 协议的聊天机器人——ESP32 负责语音入口云端大模型负责理解与生成MCP 协议负责让 AI 反过来调用灯光、喇叭、GPIO 这些硬件能力。离线语音唤醒在芯片本地运行唤醒不依赖网络覆盖 138 个板卡目录、171 个固件变体从面包板接线到商业成品板都有适配WebSocket 与 MQTTUDP 双传输通道Wi-Fi、4G 模块都能接 ESP32 语音助手 DIY 准备清单名称版本或型号用途是否必需ESP32-S3 开发板8MB Flash 以上如 M5Stack CoreS3主控、音频与唤醒词处理是麦克风 功放模块INMP441、MAX98357 及杜邦线面包板方案的语音输入输出面包板方案必需ESP-IDF SDKv6.0.2主线要求 v6.0编译与烧录自行编译时必需VSCode 或 Cursor ESP-IDF 插件最新版图形化编译与配置自行编译时必需官方服务器账号xiaozhi.me 免费注册大模型对话、OTA 升级首次对话必需小智 AI 聊天机器人的面包板演示麦克风、扬声器与 ESP32 的完整连接⏱ 五步跑通固件第 1 步拿到代码。git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32做完后终端里出现项目目录进入它再继续。第 2 步选定芯片目标。idf.py set-target esp32s3做完后生成sdkconfigmenuconfig 里才能看到板卡选项。第 3 步选板卡、开唤醒词。idf.py menuconfig在Xiaozhi Assistant下选择你的板卡Wake Word Type默认是 DISABLEDS3/P4 选USE_AFE_WAKE_WORD。做完后配置写回sdkconfig。不想自己编译的话也可以直接下载官方现成固件烧录新手建议先走这条路。第 4 步编译烧录。idf.py build idf.py -p /dev/ttyUSB0 flash monitor做完后串口监视器开始滚动日志。第 5 步首次配网。设备会自动开热点手机连上后在浏览器里填 Wi-Fi 账密。完成后设备进入监听状态喊唤醒词就能开始对话。 功能深挖最值得用的三件事离线语音唤醒不靠云端就能叫醒云端唤醒需要先把语音传上去延迟高还费流量。这个项目的唤醒词完全跑在芯片本地S3/P4 走 AFE 的 WakeNetC3 等轻量芯片用独立 WakeNet。想喊自己的名字在 menuconfig 选USE_CUSTOM_WAKE_WORD填上模型名和显示词即可唤醒词模型存放在 assets 分区能随 OTA 更新不用重刷固件。ESP32 与麦克风、扬声器、传感器的完整连接方案MCP 协议让大模型碰到硬件大模型只会说话不会控制设备。MCP 解决这个问题设备连上服务器后后台用tools/list拉取本机工具清单需要控制时用tools/call下发调用设备端一行McpServer::AddTool就能注册新工具。ESP-HI 机器狗就注册了self.dog.forward、self.light.set_rgb你说往前走走它就真的动。音量、LED、GPIO 等设备端工具开箱可用云端侧还能扩展到智能家居、PC 桌面操作、知识搜索。通过 MCP 协议实现设备与云端 AI 的协同控制双通信通道WebSocket 和 MQTTUDP 是两条可选传输链路MQTT 走控制消息UDP 承载音频并带加密与乱序防护弱网环境多一层备选。 想改哪里就去哪个目录改硬件引脚、显示、按钮main/boards/每块板一个目录config.h管引脚、config.json管发布配置改唤醒词引擎main/audio/wake_words/改界面、字体、表情包main/display/lvgl_display/对接自己的服务器协议main/protocols/从零写新板卡看完整指南docs/custom-board_zh.md⚠️ ESP32 语音助手避坑速查表现象可能原因处理办法menuconfig 里看不到目标板卡没先选芯片目标先执行idf.py set-target再打开 menuconfig编译报 SDK 或组件错误IDF 版本不匹配主线用 ESP-IDF v6.0.2v5.5 仅兼容文档标注的旧板卡唤醒词怎么喊都没反应唤醒默认 DISABLEDmenuconfig 里选USE_AFE_WAKE_WORD或USE_CUSTOM_WAKE_WORD能对话但没声音I2S 引脚或编解码芯片配置不符对照对应板卡目录config.h里的引脚定义逐一核对OTA 升级后自己的固件被覆盖直接改了已有板卡的配置编译在main/boards/新建目录并使用唯一的板卡类型蓝牙配网搜不到设备BluFi 与热点配网互斥menuconfig 里只保留其中一种配网方式更进一步想换大模型就在自己服务器部署一个兼容的 xiaozhi 服务端README 列了 Python、Java、Go 等多个开源实现设备端无需改动即可对接想给设备加新技能照 docs/mcp-usage_zh.md 注册 MCP 工具想深挖音频流水线、AEC 全双工的实现读 main/audio/README.md 里的架构图就够了。今晚就把手头那块开发板翻出来先刷一个现成固件走通对话。卡在哪一步就先查上面的避坑速查表再看对应板卡目录的说明——等你第一次听到它应声回答你的声音时会明白这套东西值得继续折腾下去。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考