xiaozhi-esp32 如何把一块 ESP32 开发板变成 AI 语音助手完整上手指南【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32xiaozhi-esp32 是一个开源的固件项目它把 ESP32 系列开发板变成能听懂话、能对话、还能执行指令的 AI 语音聊天机器人固件跑在板子上大模型推理在云端完成个人用户免费接入官方服务器即可体验。它适合手里有 ESP32-S3 或 CoreS3 这类开发板、想动手做一个语音设备的电子爱好者也适合想研究嵌入式 AI 交互流程的开发者。唤醒、对话、控制一个固件就搞定把开发板插上电说出Hi 小智板子就会进入聆听状态你说完一句云端大模型Qwen、DeepSeek 等生成回复并以 Opus 音频流的形式流式播出来。整个过程不需要你写一行代码固件里已经包含了完整的链路基于 ESP-SR 的离线语音唤醒唤醒词识别发生在板子上还支持训练自定义唤醒词流式语音识别ASR→ 大模型语义理解 → 多语言语音合成TTS的回传设备端 MCP 工具让大模型反过来控制板子上的硬件比如音量、灯光、电机、GPIO屏幕端支持 OLED/LCD 表情显示部分硬件还支持摄像头视觉输入。MCPModel Context Protocol在这里的作用可以理解成给 AI 和硬件之间定了一套普通话。过去想让大模型控制某个设备要为每个设备单独写接口用了 MCP 之后设备端用同一套协议暴露能力云端 AI 按标准调用它新增功能就变成了新增一个工具而不是重写通信逻辑。从克隆到出声音开发环境只需要三条命令如果你不想先搭开发环境官方固件可以直接烧录默认接入 xiaozhi.me 官方服务器注册个人账号即可免费使用 Qwen 实时模型。想自己编译的话环境要求是 ESP-IDF 插件主线首选 v6.0.2v5.5 仅保留给少数标注了旧版兼容的硬件。git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32 cd xiaozhi-esp32 idf.py menuconfig进入 menuconfig 后第一件事是选择你的开发板型号项目通过 Kconfig 把板卡、Wi-Fi 配网方式热点或 BluFi、AI 服务参数都收敛在这一个界面里。选好后回到命令行idf.py build flash monitor首次启动时用热点配网把 Wi-Fi 交给设备之后就可以对着它说话了。编译慢的话建议用 Linux 环境比 Windows 快很多也省掉串口驱动的麻烦。没有现成设备用面包板方案从零接线手上只有一块裸板和元件也能玩起来。仓库里的面包板方案是最小成本路线ESP32 主控加麦克风、扬声器和按键用杜邦线搭在面包板上即可接线图直接看下面这张面包板配置对应 main/boards/ 目录下的 bread-compact-wifi 等板卡定义里面的 config.json 声明了每个外设占用的引脚这也是所有板卡适配的统一格式。搭好之后对话链路和成品硬件完全一致区别只在外观。支持哪些硬件6 个芯片平台、138 个板卡目录选型前先看数字项目覆盖 ESP32、ESP32-C3、ESP32-C5、ESP32-C6、ESP32-S3、ESP32-P4 共 6 个芯片平台仓库里维护着 138 个板卡目录、171 个固件发布变体常见型号如 M5Stack CoreS3、乐鑫 ESP32-S3-BOX-3、LILYGO T-Circle-S3、微雪 ESP32-S3-Touch-AMOLED-1.8 都在其中另有 38 种界面语言可选语音提示缺失时会自动回退英文。网络方面不只是 Wi-Fi固件同时支持有线以太网、USB RNDIS以及 ML307/EC801E、NT26 等 Cat.1 4G 模组部分硬件还能在 Wi-Fi 和 4G 之间切换——这意味着同一个固件既能放在书房也能带到没有 Wi-Fi 的现场。进阶玩法换唤醒词、加屏幕表情、扩展 MCP 工具出声音只是起点项目把个性化做成了内置能力自定义唤醒词通过 ESP-SR 训练流程录自己的短语替代默认的Hi 小智界面定制表情、字体、聊天背景都可以替换官方提供网页端 Assets 生成器在线修改后打包进固件能力扩展云端 MCP 可以挂接智能家居控制、PC 桌面操作、知识搜索、邮件收发等工具设备端 MCP 则负责本地硬件控制两边共用同一套协议。想改硬件而不是软件时自定义开发板指南 讲清楚了新建一个板卡目录需要哪些文件MCP 协议用法 和 设备端 MCP 交互流程 则分别说明云端工具怎么接入、设备端调用是怎么发生的。遇到 Wi-Fi 配不上、烧录失败这类问题先看 docs/ 目录里的协议文档WebSocket 与 MQTTUDP 两套传输方案各有说明仍解决不了再到项目 Issue 区提问把芯片型号和日志带上回复会快很多。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考