企业官网建设流程全解析

如何把 ESP32 变成 AI 语音助手：xiaozhi-esp32 完整指南

【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32

xiaozhi-esp32 是一个基于 MCP 协议的 ESP32 语音聊天机器人固件：烧录后对它喊一句唤醒词，它就能听你说话、回答问题和控制灯光。本文适合没碰过嵌入式的硬件新手和学生，讲清买什么板子、怎么烧录、跑通后能玩什么。

🔎 这是个什么东西

MCP（Model 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 或经典 ESP32（NodeMCU 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.x）：

git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32 cd xiaozhi-esp32 idf.py menuconfig # 选板型与参数 idf.py build

⏱ 跑通需要几步

1. 烧录固件（新手走现成固件，开发者走上面源码路径）
2. 开机后手机连上设备发出的 Wi-Fi 热点，输入你家 Wi-Fi 密码完成配网（配网就是让设备连上你家里网络的过程）
3. 在 xiaozhi.me 注册账号，把设备绑定并激活
4. 对着设备喊"你好小智"，听到提示音说明唤醒成功
5. 说一句话，验证它语音回答
6. 说"把音量调到 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