如何用30分钟打造一台会说会答的ESP32 AI聊天机器人xiaozhi-esp32 完整上手指南与新手清单【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32xiaozhi-esp32 是一款开源的 ESP32 AI 语音聊天机器人语音唤醒、大模型对话、语音应答一站式打通还能通过 MCP 协议控制灯光、电机和 GPIO。烧录一份固件你就得到一位能对话的语音助手。这个项目替你解决了什么 这一节帮你在动手前先判断它适不适合你的需求。AI 硬件新手不用从零写唤醒、ASR、TTS 协议烧录现成固件就能体验语音 大模型的完整链路创客玩家手里的 ESP32-S3 / C3 开发板可以直接变成一台会聊天的桌面设备在校学生把离线唤醒 → 流式识别 → 大模型 → 语音合成整条流水线当活教材硬件小团队仓库覆盖138 个板卡目录、171 个固件变体可直接当作移植参考实现它背后的思路很简单设备端负责听和说大模型负责思考而 MCPModel Context Protocol 让 AI 还能反过来指挥设备本身。开工清单硬件、软件、网络一张表这一节把三要素合并成一张清单照着勾选就能开工避免装到一半发现缺东西。类别必备项建议说明硬件ESP32 开发板ESP32-S3 优先也支持 C3 / C5 / C6 / P4 等平台硬件I2S 数字麦克风 小扬声器各 1 个输入输出成品开发板通常已集成硬件显示屏可选OLED / LCD用于显示表情与状态软件操作系统Linux 优先编译更快免去驱动折腾软件VSCode 或 Cursor ESP-IDF 插件IDF 首选v6.0.2新手可直接用预编译固件跳过编译环境网络2.4GHz Wi-Fi信号稳定配网与对话都依赖它两个提醒主线已迁移到ESP-IDF v6.0v5.5 仅为旧版硬件保留版本选择细节见 docs/esp-idf-6-migration.md。支持 ESP32、ESP32-C3/C5/C6、ESP32-S3、ESP32-P4 共 6 类芯片选板时留意芯片型号与固件匹配。最小可行路径四步先跑通一次 ⚡这一节给你最短路线——目标只有一个让设备开口和你对话其余参数以后再调。克隆仓库git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32选择板型你的板子在 main/boards/ 下有对应目录如乐鑫 esp32-s3-box-3、M5Stack core-s3、立创实战派等就选它拿不准就选官方推荐的预编译固件变体。烧录固件USB 连接开发板用免开发环境的烧录方式如 docker/firmware-builder/ 或 ESP-IDF 插件选择对应变体一键烧录。重要当前 v2 分区表与 v1不兼容无法通过 OTA 互相升级。如果你手里是 v1 老硬件只能手动重新烧录升级到 v2分区布局对比见 partitions/v2/README.md。配网并对话设备开机后走热点或 BluFi 配网接入 Wi-Fi注册一个官方账号即可免费调用 Qwen 实时模型说出唤醒词开始第一句对话。跑通这一步核心链路唤醒 → 识别 → 大模型 → 合成就已经全部工作了。按需配置真正值得调的只有三项这一节只讲关键参数怎么改不重复烧录流程。唤醒词基于 ESP-SR 实现离线唤醒支持自定义唤醒词模型存放在assets分区可联网更新无需重新烧录。适合改一个顺口的名字比如小智小智。Wi-Fi 配网内置热点与 BluFi 两种方式后者走蓝牙传输凭据适合不方便改配网逻辑的场景详见 docs/blufi_zh.md。服务器固件默认接入 xiaozhi.me 官方服务器注册账号后免费使用 Qwen 实时模型也可以自部署服务端替换通信层支持 WebSocket 与 MQTT UDP 两种传输协议细节分别在 docs/websocket_zh.md 和 docs/mqtt-udp_zh.md。想改界面语言、字体、表情或聊天背景界面已内置 38 种语言资源同样走assets分区联网更新。排错手册按症状对号入座 这一节把高频问题整理成症状 → 原因 → 解法出问题时先查表再动手。症状可能原因解法Wi-Fi 连不上SSID / 密码错误或用了 5GHz 频段核对账号密码路由器单独开启 2.4GHz烧录失败、识别不到设备数据线只能充电、USB 驱动缺失换一根能传数据的线Windows 下补装驱动唤醒后没有应答未连上服务器、账号未激活确认 Wi-Fi 已连接且官方账号已注册成功语音识别不稳定环境噪声大、麦克风接线虚接换安静环境测试检查 I2S 麦克风连接老设备 OTA 升级失败v1 与 v2 分区表不兼容手动烧录 v2 固件后再启用 OTA唤醒词不响应自定义模型未下载到 assets 分区检查网络后重启设备让资源重新拉取排错顺序建议先电源、再网络、后语音逐层往上查避免一上来就怀疑大模型。进阶玩法让 AI 反过来指挥设备 ️这一节帮你把聊天玩具升级成可控设备也是这个项目最有延展性的部分。设备端 MCP设备通过McpServer::AddTool注册工具大模型发现后可直接调用。音量、灯光、电机、GPIO 都是现成例子注册写法参考 main/mcp_server.cc完整用法见 docs/mcp-usage_zh.md。云端 MCP 扩展把能力从设备搬到云端——智能家居控制、PC 桌面操作、知识搜索、邮件收发让对话变成办事。二次开发方向新硬件适配照 docs/custom-board_zh.md 给自己的板子建一个目录加入 main/boards/ 即可参与构建矩阵通信层替换对照 docs/websocket_zh.md / docs/mqtt-udp_zh.md 自搭服务端资源定制字体、表情、唤醒词模型都走assets分区改动后免烧录直接生效收尾下一步往哪走小智把语音 大模型最难的协议层封装成了固件你只需要关注两件事选一块板、说一句话。跑通最小路径之后建议依次尝试——换个唤醒词、加一个自己的 MCP 工具、适配一块新板卡。遇到问题优先在仓库提交 Issue 描述症状或直接加入项目 Discord / QQ 群1011329060提问想深入从 docs/mcp-protocol_zh.md 读起理解设备端 MCP 的完整交互流程想贡献项目以 MIT 许可开源商用自由板卡与语言包的 PR 都受欢迎每一块 ESP32 都值得有一个能对话的灵魂现在就可以动手了。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考