ESP32-C3 百元级机器狗从组装到 AI 对话的完整上手指南ESP-HI【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32给机器狗接上电源你喊出唤醒词它抬起头0.96 寸彩屏切换到专注的表情云端 AI 的答复从小喇叭里传回来——这就是 ESP-HIESP Friends 团队基于 ESP32-C3 芯片做的开源 AI 对话机器狗。BOM 成本在一百元以内下面按你动手的时间线从接线讲到第一次对话。ESP-HI 项目速览ESP32-C3 机器狗的架构与硬件清单整机的软件分四层核心层是运行音频、显示与动作任务的 ESP32-C3交互层负责麦克风拾音、喇叭与彩屏表情控制层驱动四路舵机与 WS2812 灯网络层承载 Wi-Fi、Web 远程控制与 MCP 工具协议。组件型号/规格大致成本作用主控芯片ESP32-C3RISC-V 双核约 20 元核心计算与 Wi-Fi显示0.96 寸 SPI 彩屏 160×80约 15 元表情与状态显示音频ADC 麦克风 PDM 喇叭约 10 元语音拾取与播放舵机4 路约 40 元四肢行走动作灯光WS2812 寻址灯 ×4约 5 元状态指示与氛围算上结构件整套物料总成本通常在百元以内。动手前准备机器狗物料清单与 ESP32-C3 开发环境采购清单机器狗部件的一句话说明ESP32-C3 主控整机的大脑自带 Wi-Fi 与内置 ADC0.96 寸 SPI 彩屏显示表情与状态ADC 麦克风 PDM 喇叭模块语音输入输出舵机 ×4驱动前左、前右、后左、后右四条腿WS2812 灯 ×4状态指示价格以上表为准这里不再重复。开发环境ESP-IDF 固件编译的前置条件按官方流程安装并初始化 ESP-IDF项目脚本以 6.0 系列为默认版本环境中有可用的 Python 3编译脚本为 Python 编写一根可传数据的 USB 数据线一个 Wi-Fi 路由器机器狗需联网使用云端对话从零到通电ESP32 机器狗组装、烧录与首次点亮组装与接线ESP32-C3 引脚对照按接线图把各模块接到主控上关键引脚是PDM 喇叭接 GPIO6/7GPIO3 为功放使能麦克风走 ESP32-C3 内置 ADC 的 2 号通道屏幕走 SPI2MOSI 为 GPIO4、SCLK 为 GPIO5、DC 为 GPIO10四路舵机分别对应 GPIO21前左/19前右/20后左/18后右WS2812 接 GPIO8。功能按键三个BOOT 键 GPIO9、动作唤醒键 GPIO0、语音唤醒键 GPIO1。图中看不清引脚编号时直接对照上表。首次烧录绕过舵机占用 USB的 4 个步骤ESP-HI 的舵机控制信号占用了 USB Type-C 接口身体正常连接时电脑无法识别设备。因此首次烧录这样做断开电源把身体与头部拆开只保留头部按住头部的按钮再把 USB 数据线接入电脑此时 ESP32-C3 进入烧录模式克隆仓库并执行编译脚本生成固件随后写入设备烧录完成后重新插拔电源头部与身体接回上电。git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32 python ./scripts/build.py espressif/esp-hi脚本会自动套用 ESP32-C3 目标芯片与全套 sdkconfig 选项编译完成后再执行idf.py flash写入。首次点亮屏幕、喇叭与灯光基础自检上电后观察三点彩屏亮起并播放开机表情动画无偏色喇叭播放欢迎音PDM 喇叭起始音量偏小属正常WS2812 随状态变化Wi-Fi 连接成功时会点亮。屏幕不亮先查 SPI 接线与屏供电无声则查 GPIO3 功放使能线。连网阶段按住 BOOT 键可进入 Wi-Fi 配网模式。核心体验从第一句话到手机远程操控和它说第一句话唤醒词到 AI 对话的完整链路设备就绪后喊出预设唤醒词你好小智屏幕切换为聆听表情灯光变色唤醒确认后直接提问音频经 WebSocket 上传由云端 AI 处理AI 回复返回PDM 喇叭播放屏幕同步显示对应表情想随时打断或结束快速双击动作唤醒键GPIO0即可切换对话状态长按 BOOT 键同理。看它动起来机器狗动作分类速览类别典型动作一句话场景基础移动前进、后退、左转、右转、停止让它在桌边走一圈扩展动作趴下、握手、伸懒腰、向前跳跃来客人时表演灯光开灯、关灯、自定义 RGB状态与氛围切换这些动作不必手动触发对 AI 说一句握个手它会通过工具调用直接执行原理见下一节。从手机远程控制esp-hi.local Web 界面手机与机器狗连到同一个 Wi-Fi浏览器打开http://esp-hi.local/即可用内置的 Web 控制页操作各个动作、查看设备状态相当于把遥控器放进了手机。进阶与扩展MCP 协议与自定义工具注册ESP-HI 是一个MCP 化设备MCPModel Context Protocol是一套让大模型调用设备工具的协议。它在板级代码里通过 McpServer 注册了三类工具self.dog.basic_control管基础移动self.dog.advanced_control管扩展动作self.light.set_rgb管灯光颜色。注册逻辑在 MCP 工具注册源码协议实现见 MCP 服务。4MB Flash 分区、精简的 Wi-Fi 缓冲、FreeRTOS 提频等资源优化都写在 板级配置文件 里不想开 Web 控制时关掉对应的编译选项即可。常见问题ESP32-C3 机器狗烧录失败与唤醒词不准电脑识别不到设备确认身体已拆开只连头部检查是否按住按钮后再插线并用数据线而非纯充电线仍无反应时更换 USB 口重新进入烧录流程唤醒词识别率不高麦克风是 ESP32-C3 内置 ADC拾音半径有限保持在 1 米内、降低背景噪声把测试位置换到机器狗正前方再试上电后没有反应按住 BOOT 键进 Wi-Fi 配网核对网络名与密码需要看日志时把控制台切到 USB Serial/JTAG注意该模式会禁用舵机控制下一步继续折腾这台机器狗的 3 个具体方向阅读partitions/v2/4m.csv与 config.json弄清 4MB Flash 的分区方式尝试其他分区方案看能否腾出空间放更多资源参照InitializeTools的写法注册一个新的self.工具比如自定义一个挥手动作让 AI 在对话中调用它浏览main/boards/目录看同一套框架如何适配 M5Stack、微雪等不同硬件再考虑移植到你自己的板子上机器狗跑顺之后更有趣的部分才开始——它的每个动作都对应几行 C 代码改哪一行、会发生什么源码都摆在仓库里。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考