从 0 到跑通只要 30 分钟ESP-SparkBot 语音控制机器人新手完整指南【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32这个项目把一块 ESP32-S3 机器人开发板变成能对话、会走路、能跳舞、还会拍照的语音控制机器人。你只要会接几根线、有一台电脑大约 30 分钟就能让 ESP-SparkBot 语音控制机器人跑起来并顺带掌握固件烧录和 MCP 工具自定义的完整流程。项目速览ESP-SparkBot 语音控制机器人能干什么xiaozhi-esp32 是一个基于 MCPModel Context Protocol一种让大模型调用外部工具和设备的标准协议的开源固件项目ESP-SparkBot 是它支持的一种带底盘的机器人硬件形态。核心亮点自然语音双向对话云端接入 Qwen / DeepSeek 大模型支持离线语音唤醒履带式双电机底盘前进、后退、左转、右转还有一段固定的跳舞动作内置 OV2640 摄像头模组200 万像素 CMOS 传感器240×24025fps机器人能看见并描述画面240×240 彩色屏显示表情灯光效果可按语音指令切换仓库收录 138 个板卡目录、171 个固件变体手里有其他板子大概率也能直接用首次编译烧录固件烧录最短路径先说前提项目要求 ESP-IDF乐鑫官方嵌入式开发框架v6.0.1 及以上推荐 v6.15.x 已不再支持。如果完全不想搭开发环境仓库发布页也提供现成固件可以直接烧录、跳过本节。自建路径一共 4 步安装 ESP-IDF v6.1 框架官方一键安装器即可Linux 上编译比 Windows 快。获取项目代码git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32 cd xiaozhi-esp32指定目标芯片并编译ESP-SparkBot 使用 ESP32-S3 双核微控制器主频 240MHzidf.py set-target esp32s3 idf.py build烧录固件并打开串口监控端口名改成你机器上实际的idf.py -p /dev/ttyUSB0 flash idf.py -p /dev/ttyUSB0 monitor烧完首次开机时按住 BOOT 键进入 Wi-Fi 配网连上网络、在 xiaozhi.me 官方服务器注册账号个人免费后即可开始对话。场景体验你可以对它说做的 5 件事烧录开机后用下面的方式试试它的反应说前进→ 机器人往前挪一小段后退左转右转同理。这 4 个动作是固件里 4 个独立的控制工具每个工具都会通过串口向底盘驱动板发一条简短指令。说跳舞→ 底盘执行一段固定舞蹈同时灯光切到展示模式属于动作灯光的组合技。说换个流光灯光效果→ 灯光切换工具会把 1~6 的模式编号发给底座灯光变成呼吸、流光或常亮效果当前模式也能用语音查询。问你前面是什么→ OV2640 摄像头抓拍一张图送到云端大模型描述画面内容如果画面是反的说一句翻转图像即可翻转状态会写入本地存储重启后依然生效。按 BOOT 键→ 短按开启/结束一轮对话开机画面阶段长按则进入 Wi-Fi 配网模式。它是怎么工作的一句话如何驱动机器人大白话版本机器人自己不做思考它是一台语音中转站——负责麦克风、喇叭、屏幕、摄像头和电机这些外设并把一组工具注册给大模型大模型想让它干什么就调用哪个工具。一行流程你的语音 → 唤醒/语音识别 → 大模型理解意图并选中工具 → 固件执行对应动作移动/灯光/拍照→ 结果转成语音反馈硬件清单与接线要点5 个部件与引脚分配部件型号/规格作用主控ESP32-S3 双核240MHz带 Wi-Fi/蓝牙跑固件处理音频与图像链路音频编解码ES831116kHz 麦克风输入与喇叭输出彩屏240×240 SPI LCDST7789 驱动芯片显示表情与状态摄像头OV2640DVP 接口240×24025fps图像采集运动底盘履带式底盘电机驱动板串口连接前进/后退/转向/跳舞接线要点对照丝印核对编号即可无需背代码音频 I2S 五根线MCLKGPIO45WSGPIO41BCLKGPIO39麦克风输入 DINGPIO40喇叭输出 DOUTGPIO42I2C 控制线 SDA/SCL 为 GPIO4/5功放使能 GPIO46。屏幕 SPI时钟 SCKGPIO21数据 MOSIGPIO47片选 CSGPIO44数据/命令 DCGPIO43背光与功放使能共用 GPIO46所以固件不会主动关断喇叭。摄像头XCLKGPIO15PCLKGPIO13VSYNCGPIO6HSYNCGPIO78 位数据 D0~D7 占用 GPIO8~18初始化时复用音频那条 I2C 总线不用多布线。电机底座两线串口TXGPIO38RXGPIO48波特率 115200上电时固件会发一条 w2 指令让底座灯亮起。不动了快速自检4 个最常见的故障排查项烧录命令提示找不到串口先确认 USB 线是数据线而非纯充电线再核对端口名Linux 通常是 /dev/ttyUSB0 或 /dev/ttyACM0并检查是否安装了串口驱动。ESP-SparkBot 机器人喊前进不动十有八九是底座通信问题——核对两线串口是否接在 GPIO38/48、底座是否供电并在串口监控里观察有没有电机指令输出。编译成功但开机连不上服务器、无法对话首次开机按住 BOOT 键进入配网模式配置 Wi-Fi固件默认接入 xiaozhi.me 官方服务器注册账号后才能使用大模型。屏幕黑屏或显示错色对照上表核对屏幕 SPI 四根线及 DC/CS 引脚定义确认背光引脚 GPIO46 已接好。往哪里扩展想加功能时去哪里看加自己的语音指令看 main/boards/espressif/esp-sparkbot/esp_sparkbot_board.cc 里的工具注册部分前进、灯光、摄像头翻转都是同一套写法加出来的。理解控制协议MCP 物联网控制用法在 docs/mcp-usage_zh.md交互流程细节在 docs/mcp-protocol_zh.md。移植到自己的板子docs/custom-board_zh.md 是自定义开发板指南main/boards/ 下每个目录都是可参照的样板结构WebSocket 与 MQTTUDP 两种通信协议分别在 docs/websocket_zh.md 和 docs/mqtt-udp_zh.md 有完整说明。改唤醒词与语音资源38 种语言的语音提示与通用音效在 main/assets/ 目录下管理。收尾跟完这篇你得到什么你会得到一台能对话、会动的 ESP-SparkBot 语音控制机器人外加一套可复用的固件烧录、MCP 工具扩展与排障经验。有具体问题和改进建议直接去仓库的 issue 区以及 README 里列出的社区入口提问即可维护者和贡献者都很活跃。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考