从开箱到开口对话小智ESP32安装配置完整指南【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32你对着桌上的一个小设备说了句今天天气怎么样两三秒后它用自然的语气把答案念了出来。这不是科幻片道具——用一块 ESP32 开发板就能造出来。小智ESP32xiaozhi-esp32就是一个基于 ESP32 的 AI 语音聊天机器人项目MIT 协议发布可以免费用于学习和商业场景代码以 C 为主76.4%搭配少量 C13.6%和 Python9.2%。这篇文章带你完成小智ESP32安装与配置从拉代码到第一次开口对话。先搞清楚它凭什么听得懂、说得出第一次接触 ESP32 接入大模型的朋友最容易把一堆术语当成黑盒。其实把一次对话拆开看每个技术组件都只负责链路上的一段ESP-SR耳朵离线语音唤醒引擎让你喊一声就能把设备叫醒不依赖云端。大模型大脑Qwen、DeepSeek、Doubao 这类模型负责想——理解你的问题并组织回答内容质量基本由它决定。3D Speaker / SenseVoice声音与身份3D Speaker 承担语音合成把文字变成听得舒服的语音SenseVoice 做声纹识别知道现在说话的是谁。流式协议电话线你的声音被压缩后通过 WebSocket 或 UDP 传出去回答也顺着同一条线流回来——像打电话边说边传所以听起来不是一问一答的卡顿而是流畅的对话。屏幕与外设脸OLED/LCD 负责表情和文字呈现麦克风与扬声器则是这条链路的物理端点。动手前检查清单硬件与软件各就位开工前逐项打勾比翻车后排查省心得多。硬件栏检查项缺了会怎样如何验证已就绪ESP32 开发板带 Wi-Fi/蓝牙整个项目的载体没有它无从谈起通电后板载指示灯亮起仓库支持 ESP32、C3、C5、C6、S3、P4 多个芯片平台麦克风设备只能听天书唤醒和提问都失效对着说话时录音波形软件能看到波动扬声器回答只能看不能听语音体验减半播放任意音频能出声、无明显破音OLED / LCD 屏可选没有表情和文字反馈但核心对话功能不受影响显示测试图案正常无亮线软件栏检查项缺了会怎样如何验证已就绪Arduino IDE ESP32 支持包Boards Manager 安装无法编译上传卡在第 3 步IDE 下拉列表里能选到对应型号的开发板Git拉不到项目代码终端执行git --version输出版本号ESP32WiFi 等依赖库编译报错提示找不到库IDE 的管理库里能看到已安装版本提示仓库支持 138 个板卡目录、171 个固件变体你的板子大概率已有现成配置以仓库最新 README 为准确认支持情况。上手五步从拉代码到开口对话第 1 步拉取项目代码在终端执行一条命令把代码拿到本地git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32验证点命令跑完后出现同名文件夹打开能看到main/、docs/、sdkconfig.defaults等内容。第 2 步配好开发环境按上一条清单装好 Arduino IDE、ESP32 支持包和依赖库如果走官方推荐的 ESP-IDF 路线用 VSCode 或 Cursor 装上对应插件即可Linux 下编译更快也更少驱动麻烦。验证点IDE 的板卡列表里出现 ESP32 系列型号依赖库在管理库中全部就位。第 3 步选板选口按硬件微调配置在 IDE 里选中你的开发板型号和正确端口再按自己的硬件修改工程里的配置项参考 docs/custom-board_zh.md 的自定义板卡写法。验证点下拉板子时型号能精确匹配比如 S3 不要选成 S2端口与第 4 步的识别结果一致。第 4 步编译并烧录固件连接开发板执行编译上传。验证点编译日志走到 Hard resetting 或类似成功提示设备重新上电后屏幕出现开机画面串口监视器能滚动出日志。第 5 步配网、接入服务器开口对话在配置里填好 Wi-Fi 的 SSID 与密码以及 MQTT 服务器地址和端口协议细节可看 docs/mqtt-udp_zh.md 和 docs/websocket_zh.md重启设备唤醒词一喊说出你的第一句话。验证点屏幕或日志显示网络已连上问一句现在几点了设备用语音正常回答——到这里小智ESP32安装就算完成了。容易翻车的三件事Wi-Fi / MQTT 配置填错现象设备反复重启或日志里网络一连上就断开。原因SSID、密码或 MQTT 地址端口有一个字母的误差设备就找不到服务器。一句话解法把配置里所有网络参数逐字与路由器后台核对一遍注意大小写和隐藏字符。串口识别失败现象IDE 端口下拉里一片空白或烧录时突然中断。原因USB 线只供电不传数据或板卡没有进入烧录模式。一句话解法换一根数据线、换一个 USB 口再按住 BOOT 键上电让它进入烧录模式。库版本与工程不匹配现象编译一长串 undefined reference 或找不到某头文件。原因你装的库版本和工程要求的 ESP32 支持包版本对不上。一句话解法按 docs/ 里的迁移与兼容性文档把工具链和库统一升到仓库推荐的版本再重新编译。下一步可以玩什么换大脑在 Qwen、DeepSeek、Doubao 之间切换大模型对比不同性格的回答风格看哪个更合你的口味。换身体仓库里 138 个板卡目录就是灵感库——带摄像头的、带触摸屏的、4G 联网的挑一个顺手的把小智ESP32装上去。进圈子把踩过的坑写成 Issue 抛给仓库或加入 README 里提到的 Discord、QQ 群1011329060和把 ESP32 玩出花的人聊聊。祝你的第一声你好尽快被一只 ESP32 接住。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
