把 ESP32 变成 AI 语音助手xiaozhi-esp32 完整上手路线【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32给 ESP32 接上麦克风和喇叭喊一声唤醒词它就能听你说话、聊天还能控制灯光。这就是 xiaozhi-esp32一个基于 MCP 协议的 AI 语音聊天机器人固件大模型在云端ESP32 负责听、说和操作硬件。无论你是学生党还是想折腾硬件的开发者零硬件经验也能用一块低成本开发板做出语音助手。先搞懂 xiaozhi-esp32 的核心机制MCP 协议xiaozhi-esp32 不给每种外设单独写 AI 接入逻辑全部统一到 MCPModel Context Protocol上设备端 MCP音量、灯光、电机、GPIO 等外设被注册为工具代码里通过McpServer::AddTool注册后台先经tools/list拿到工具清单大模型再通过tools/call直接调用云端 MCP扩展智能家居控制、知识搜索、邮件收发等大模型能力语音链路Opus 音频流支持流式识别 大模型 合成也支持端到端实时语音模型带回声消除AEC的硬件可以边说边听整条流程是离线唤醒 → 联网对话 → MCP 工具调用。唤醒基于 ESP-SR不依赖网络还支持自定义唤醒词协议细节见 MCP 交互流程 和 MCP 用法说明。硬件怎么选面包板 DIY 还是现成开发板项目已覆盖 138 个板卡目录、171 个固件发布变体支持 ESP32、C3、C5、C6、S3、P4 六种芯片平台。选型看你要不要顺带学接线方案硬件适合谁面包板 DIYESP32 开发板 麦克风 喇叭 按键menuconfig 板型选面包板 ESP32 DevKit预算最低想弄懂接线与供电现成开发板ESP32-S3-BOX-3、M5Stack CoreS3 等要 AEC 全双工对话和屏幕体验开箱即完整面包板怎么接看官方接线图照着装就行想加一块自己的板卡读 自定义开发板指南 学写板卡配置文件完整硬件列表和接线说明在 README_zh.md 的硬件章节。xiaozhi-esp32 最快的上手方式两条烧录路径路径操作代价现成固件新手推荐免开发环境直接烧录官方固件默认接入 xiaozhi.me 官方服务器注册账号可免费使用 Qwen 实时模型最快零环境源码编译VSCode/Cursor ESP-IDF 插件Linux 优先要求 IDF v6.0.1 以上推荐 v6.1不再支持 5.x能改配置、改代码源码路径命令git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32 cd xiaozhi-esp32 idf.py menuconfig idf.py buildidf.py menuconfig里选板型与参数编译产物烧进开发板即可。首次配网支持热点和 BluFi 两种方式用手机热点就能完成见 BluFi 配网文档。卡住了去哪查先看这三个地方连不上 Wi-Fi先用热点配网重试支持的设备再用 BluFi 蓝牙配网核对 SSID 与密码参考 docs/blufi_zh.md唤醒词没反应先查麦克风供电与接线供电不稳会让唤醒成功率明显下降接线参考 README_zh.md 硬件章节编译失败或版本报错主线要求 IDF v6.0.1ESP32-S31 变体需 6.1新增板卡需求看 docs/custom-board_zh.md想深入协议层WebSocket 与 MQTTUDP 两种通信方式各有独立文档docs/websocket_zh.md、docs/mqtt-udp_zh.md从零到能对话的检查清单 确认硬件面包板 开发板练手或直接上带屏幕、带电池的现成板烧录现成固件最快源码开发者按上面命令编译配网热点或 BluFi连上 Wi-Fi注册账号并激活设备验证链路说出唤醒词跑通唤醒—对话—语音回复全流程再深入打开 MCP 用法说明尝试让大模型直接控制设备音量与灯光【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考