xiaozhi-esp32：从零搭好AI语音助手
【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32
你对桌上那块小圆屏说了句"关灯"，卧室的灯真的灭了。这不是演示视频，而是 xiaozhi-esp32——一个跑在 ESP32 上、基于 MCP 协议的 AI 语音助手固件：本地唤醒、云端大模型对话，还能反向控制硬件。
它凭什么能行
- 一块几十元的 ESP32 板，接上大模型就能对话
- 同一套固件适配 138 个板目录、171 个发布变体
- MCP 协议（大模型控制设备的统一接口）打通硬件与 AI
架构一句话：ESP32 端管唤醒和音频收发，MCP 像一套"普通话"，云端大模型和本地音箱、灯、舵机都能用同一种方式被调用。
小智用MCP同时管本地硬件和云端服务
🎯 跑通它要几步
① 克隆仓库，装好 ESP-IDF v6.0.2，打开工程：
git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32②idf.py menuconfig里选板型、配 Wi-Fi；懒人可直接刷官方预编译固件 ③ 编译烧录，首次开机连手机热点完成配网，喊唤醒词就上线
（最低配置：ESP32-C3 + 面包板 + 麦克风喇叭，约30元）
面包板接法：麦克风、喇叭、按键一条线搞定
能玩出什么
- 语音控灯、控音箱这类智能家居
- 闲聊、讲笑话、查天气
- 表情屏实时显示状态和 emoji
- 加摄像头让它"看到"你
- 换自定义唤醒词，叫你的名字
几十元物料就能跑起来的语音助手
怎么改成"你的"
- 换硬件：main/boards/ — 138 个板目录，照着抄一份就能加新板子
- 改声音：main/audio/ — 音频编解码、唤醒词、回声消除都在这
- 改界面：main/display/ — OLED/LCD 主题、emoji、表情动画
- 换协议：main/protocols/ — WebSocket 和 MQTT/UDP 两套传输
🔧 卡住了查这里
| 典型症状 | 30秒处理 |
|---|---|
| 唤醒后没反应 | 先确认Wi-Fi连上服务器 |
| 频繁重启 | 查供电，换USB口或电源 |
| 找不到板型 | 跑--list-boards列板名 |
| 唤醒率低 | 安静处重录、重训唤醒词 |
去哪找答案
- 文档目录：docs/ — 自定义板、MCP 协议、WebSocket 协议都有
- Issue：仓库 Issue 区，贴完整串口日志再提
- 社区：xiaozhi.me 控制台，README 里也有官方文档站入口
clone下来，menuconfig里选块板子，今晚就能让它叫你名字。
【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
