新手30分钟上手指南小智ESP32 AI聊天机器人从烧录到第一次对话【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32按下电源键对它说你好小智指示灯亮起它开始回答你的问题、调音量、控制灯。这就是小智ESP32xiaozhi-esp32一个基于ESP32的开源AI聊天机器人支持离线语音唤醒、大模型对话和MCP协议设备控制MIT协议免费使用。本文按先决策、再点火、后排障的顺序带你跑通它。先想清楚三件事选板子、选服务端、清点外设新手选板子推荐选板子的逻辑是第一次上手优先买麦克风、喇叭、屏幕、电池都集成好的整机板省掉焊接和接线确认项目支持你的板子后直接选对应的预编译固件即可。项目当前支持138个板卡目录、171个发布变体芯片覆盖ESP32、C3、C5、C6、S3、P4。预算敏感、国内采购方便立创·实战派 ESP32-S3集成常用外设社区教程最多。想要全双工体验乐鑫 ESP32-S3-BOX-3官方推荐板开启AEC后边说边听不用按键打断。模块化玩法M5Stack CoreS3后续加传感器生态方便。喜欢面包板DIY的话仓库文档里有完整的接线实践照着接I2S数字麦克风、小喇叭和OLED/LCD屏即可服务端接入怎么选固件默认接入官方 xiaozhi.me 服务器注册一个账号即可免费使用Qwen实时模型零配置成本新手首选。有编程基础、想换模型或完全掌控数据可以自建服务端社区有Python/Java/Go等多语言实现固件里改成指向你的服务器即可。外设买齐哪些集成板开箱即用无需额外采购。只有DIY路线才需要单独买I2S数字麦克风1-2个、小型有源喇叭、OLED或LCD屏外加电池管理模块如做便携设备。屏幕非必需但对话体验会好很多。最小可用路径拿固件、配Wi-Fi、完成第一次对话第一步烧预编译固件。新手不需要搭建ESP-IDF开发环境。从项目发布渠道下载对应板子的预编译固件用烧录工具如ESP Flash Download Tool选择板子和Flash大小写入。只有要改代码时才需要VSCode ESP-IDF插件首选v6.0.2及以上稳定版。第二步配Wi-Fi。项目支持热点和BluFi两种方式。设备首次启动、没有已保存的Wi-Fi时会自动进入配网热点模式下用手机连上设备开的热点在网页里填SSID和密码BluFi模式则用EspBlufi等手机App下发凭据。凭据写入NVS后重启自动连接。第三步激活并对话。设备联网后与服务器交换激活码完成绑定在屏幕或日志里按提示在账号页面完成激活然后说出唤醒词进行第一次问答。唤醒基于ESP-SR离线识别联网前也能被叫醒。传输层支持WebSocket与MQTTUDP两种方案详见WebSocket协议文档和MQTTUDP协议文档。卡住了对照这张表自查现象可能原因处理连不上Wi-FiSSID/密码输错路由器只支持5GHz确认密码连2.4GHz网络热点配网失败就换BluFi激活后设备连不上服务器设备时间未同步或网络不通检查路由器能否上网断电重启设备唤醒无响应离设备太远、环境噪音大唤醒词资源未下载完靠近麦克风用清晰语速说完整唤醒词等首次启动assets下载完成识别不准麦克风接线错误DIY板AEC未生效导致自听对照接线图复查I2S引脚确认选用带AEC的板卡变体烧录失败数据线只供电不传数串口未识别换支持数据传输的USB线检查驱动/设备管理器中的串口v1设备升级v2后无反应v1与v2分区表不兼容见下方醒目标注跑通之后下一步是MCP设备端MCP暴露音量、LED、电机、GPIO等控制能力云端MCP可接智能家居控制、PC桌面操作、知识搜索、邮件收发用法见MCP物联网控制文档。⚠️注意v2版本新增了assets分区与v1分区表不兼容v1设备无法通过OTA升到v2必须用烧录工具手动重写v2分区表和固件升级后设备首次启动会自动下载唤醒词模型、字体、表情等资源。打开项目仓库挑一块板子把固件烧进去。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考