ESP32 AI机器人从0到1xiaozhi-esp32快速上手指南【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32你在客厅喊了一声把灯打开桌上的小盒子用自然的声音回答了你灯也真的亮了。这个盒子就是刷好 xiaozhi-esp32 固件的一台 ESP32 AI机器人——ESP32 负责语音对话的收发大模型负责理解和回答两者通过标准协议连起来。它到底能干什么实时语音对话走 Opus 音频流支持流式 ASRLLMTTS带 AEC 的硬件可以做到边听边说的全双工交互。MCP设备控制设备把音量、灯光、电机、GPIO 注册成工具云端大模型可以直接调用实现 MCP 协议设备控制。多板型适配仓库内置 138 个板卡目录、171 个固件变体覆盖 ESP32、S3、C3、C5、C6、P4 等芯片平台。离线唤醒在线对话基于 ESP-SR 的本地唤醒词可自定义负责叫得醒对话内容由云端模型完成Wi-Fi、以太网、4G 都能联网。五分钟跑起来最短路径是四步拉代码 → 选板型 → 编译烧录 → 配网。先装好 ESP-IDF项目主线要求 v6.0 以上推荐 v6.0.2装完用idf.py menuconfig选择目标芯片和板型板型定义都在 main/boards/ 下按芯片分组。编译烧录命令如下git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32 cd xiaozhi-esp32 # 进入项目目录烧录前执行idf.py set-target s3按你的板子芯片调整和idf.py menuconfig选板然后idf.py build # 编译当前板型固件 idf.py -p /dev/ttyUSB0 flash monitor # 烧录并打开串口日志配网不需要改代码设备默认支持热点配网和 BluFi 两种方式上电后按提示连接配网热点即可。固件默认接入官方服务器注册账号即可免费使用 Qwen 实时模型。不想搭编译环境的话README 里也提供了免开发环境直接烧录的固件入口适合先验证效果再回头补环境。选哪块板不踩坑按两档选基本不会错板型特点适合人群M5Stack CoreS3入门档麦克风、喇叭、屏幕全集成到手即用想最快听到第一句回答的新手ESP32-S3-BOX-3入门档乐鑫官方参考设计屏幕、按键、电池齐全想完整体验功能清单再决定方向的bread-compact-wifi 面包板进阶档模块全部外接接线过程就是学习过程喜欢动手做 ESP32 智能音箱 DIY 的ESP-HI 机器狗 / SenseCAP Watcher进阶档前者带舵机底盘可演示运动控制后者带摄像头想验证 MCP 工具调用和视觉输入的玩家买板子前看一眼对应目录下的config.json里面写明了该变体的编译目标能和你手里的硬件对上再下单。MCP协议让AI接上硬件的那根线MCPModel Context Protocol是这套 AI 聊天机器人里连接大脑和身体的机制走标准 JSON-RPC 2.0。流程很短设备启动后和后台建立连接后台用tools/list拿到这台设备支持的所有工具及参数说明用tools/call发起调用——设备执行并把结果布尔、整数或字符串传回。也就是说把灯打开不再只是模型说了一句好的而是模型选中了一个带参数的工具设备真的去执行了。设备端用几行代码就能注册一个新工具云端 MCP 还能把能力扩展到智能家居、知识搜索这类场景。三个真实用法桌面语音助手唤醒后直接提问ESP32 采集语音、模型作答、本地喇叭播报构成完整的 ESP32 语音对话闭环。语音示例现在电量还有多少家居控制入口接入云端 MCP 后一句话触发后台工具。语音示例把客厅的灯打开亮度调到 50%。机器人远程操控在设备端注册前进、转向等工具模型根据指令带参数调用。语音示例向前走两步然后停下来。你大概率会踩的3个坑Q1编译直接报错提示版本不兼容主线代码基于 ESP-IDF v6.0先把 SDK 版本对齐个别旧硬件仍走 v5.5具体以板卡兼容状态表为准。Q2烧录成功但连不上 Wi-Fi确认配网流程走完了热点或 BluFi再看路由器是否限制了新设备接入4G 板子则先检查 SIM 卡是否识别。Q3嘈杂环境里唤醒不灵、说话被自己打断唤醒端检查麦克风朝向和距离自定义唤醒词需要足够的训练样本交互端全双工依赖 AEC硬件不支持时会出现回声选板时留意这一点。接下来去哪MCP 使用文档设备端如何注册工具、后台如何调用含完整 JSON-RPC 示例。自定义开发板指南手里的板子不在列表里时照着加一个板级目录。ESP-IDF 6 迁移文档171 个变体的 SDK 兼容状态和固件体积数据。这套固件把大模型装进了成本不高的芯片里ESP32 AI机器人 的门槛比大多数人想象的低。下一步很具体把开发板插上电跑通第一句语音对话。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考