企业官网建设流程全解析

让 AI 机器狗跑起来：ESP-HI 固件从零到烧录的快速指南

【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32

ESP-HI 是小智 AI 聊天机器人项目里的一套超低成本 AI 机器狗固件：一块 ESP32-C3 就能跑唤醒词检测、AI 语音对话和数十种舵机动作，还内置 WebUI 让你用手机直接操控。硬件只要百元级，编译一条命令搞定，是新手做机器人很合适的起点。

它是什么

小智 AI 是基于 ESP32 系列芯片的开源语音聊天机器人固件，ESP-HI 是其中一个板卡变体，形态是机器狗。主控用 ESP32-C3，头部装一块 0.96 寸 ST7789 彩屏（160×80）显示表情，侧面接 PDM 麦克风和 PDM 扬声器负责听和说，身体由 4 个舵机驱动行走和握手等动作。整个项目跑在 ESP-IDF 工具链上，并基于 MCP 协议把设备能力"工具化"：动作、灯光都注册成标准工具，云端大模型自己决定什么时候让它动、怎么动。它适合两类人：想花小钱做出能走能说的机器人的人，以及想从完整可运行的工程里学硬件和协议的人。

为什么值得动手

• 物料百元内搞定：主控 ESP32-C3 加一块彩屏、一对 PDM 麦克风/扬声器、4 个舵机，全是常见通用件，比市面教育机器人便宜一个量级，做坏了也不心疼。
• 不用手动调配置：这块板需要 20 多项编译选项（唤醒词、尺寸优化、4MB 分区表等），已经预先写在 main/boards/espressif/esp-hi/config.json 里，跑一条脚本就能出固件，不用逐项翻 menuconfig。
• 扩展方式标准：动作和灯光都是 MCP 工具，在 esp_hi.cc 里加几行注册代码就多一项技能；想接智能家居、知识搜索这类云端能力，看 MCP 使用文档 即可。

从零到跑通

第一步：备料

准备 ESP32-C3 模块（或已组装的头部）、0.96 寸 SPI 彩屏（ST7789）、PDM 麦克风、带功放的小扬声器、4 个舵机、1 颗灯和电池。面包板自制的按接线图把屏、音频、舵机引脚逐一接好：

第二步：克隆源码并编译

用 git 克隆源码（地址：https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32），进入目录后执行编译命令：

python ./scripts/build.py espressif/esp-hi

这一行会自动完成 ESP32-C3 目标、分区表、唤醒词等选项配置并生成固件。

第三步：烧录固件

编译结束后执行idf.py flash，固件通过 USB 写入设备，完成后断开电源重插即可。

第四步：首次验收

开机按提示配好 Wi-Fi。说出唤醒词，头部彩屏亮起表情并开始对话；手机连到同一 Wi-Fi，浏览器访问 esp-hi.local 就能打开 WebUI，点按钮让机器狗前后走动，确认舵机响应正常就算跑通。

上手后能玩什么

基础层：

• 5 个基础动作：前进、后退、左转、右转、停止，说一声或在 WebUI 点一下就能执行，适合日常交互。
• 7 个扩展动作：趴下、握手、向前跳跃、伸懒腰等，对话里让它"握个手"就是现成的演示。
• 离线唤醒 + AI 对话：唤醒检测在设备端本地运行，不用按键，唤醒后直接提问，彩屏同步情绪表情。

进阶玩法：

• MCP 工具扩展：把振动、摄像头等新能力注册成工具，大模型就能直接调度，协议细节见 MCP 协议文档。
• 灯光联动：通过内置的 RGB 工具改灯色，让机器狗随对话内容变换光效。

真实使用场景

教学演示：课堂上让小朋友说"向前走"，机器狗当场迈步，声音和动作一一对应，硬件便宜到不怕摔坏，适合反复试。

桌面陪伴：放在工位上，叫唤醒词问天气、闲聊，说话时彩屏变表情、偶尔来段摇摆或跳跃，比静态摆件有互动感。

MCP 学习样本：想理解设备端 MCP，这个项目把动作和灯光注册成工具只用了百余行代码，读源码顺带改参数，效果立刻看得见。

避坑与常见问题

• 上电后 USB 连不上电脑：舵机控制接管了 USB 口，电脑识别不到设备。处理：断开身体只留头部，按住按钮再接 USB，进入烧录模式。
• 串口看不到日志：默认日志走 USB Serial/JTAG 通道，但该设置会禁用舵机控制，两者互斥。不需要控身体时才切日志通道重新编译。
• 唤醒词不响应：麦克风是 PDM 接口、占用固定引脚（GPIO 6/7），先核对接线是否接错；唤醒功能编译时已默认开启，不用另外申请。
• WebUI 打不开：手机必须和机器狗在同一 Wi-Fi 下；确认无误仍不行，就关闭 Web 控制选项重新编译，排除干扰。

一块百元级开发板加 4 个舵机，就能得到一只会走会说的 AI 机器狗。现在把物料备齐、克隆源码、烧上这两条命令，剩下的技能就可以通过 MCP 一个个往上加。

【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32