项目>小智AI>小智 AI 快速开始:从固件到第一次对话

小智 AI 快速开始:从固件到第一次对话

摘要:六步走完最小路径:选板、下固件、烧录、2.4G 配网、6 位验证码激活、唤醒第一次对话,每步给出可核对的现象。

从固件到第一次对话的六步最小路径

本页把小智 AI 从零到第一次语音对话的最短路径串成六步,每步给出可核对的现象,细节在各专页展开。按官方 README 的建议,新手第一次操作先不要搭建开发环境,直接使用免开发环境烧录的固件;固件默认接入 xiaozhi.me 官方服务器,个人用户注册账号可免费使用 Qwen 实时模型。

开始前准备:

  • 一块支持的板子
  • 一根可传数据的 Type-C 数据线(不能用只供电的普通充电线)
  • 一台能上网的电脑

本页的烧录、配网与激活步骤来自官方教程;官方教程写作于 v0.x 固件与 ESP-IDF 5.3 时代,为早期固件口径,当前固件以 v2.5.2 发布包为准。

  1. 选板:确认自己的板型。面包板方案常用 ESP32-S3-DevKitC-1(选 WROOM N16R8 模组,16MB Flash + 8MB PSRAM);市售成品板按厂商型号对照,发布包 manifest 里可以检索到 espressif-esp-box-3、lckfb-lichuang-dev、magiclick-2p4、xmini-c3 等常见板对应的固件变体。预期结果:能说出自己板子对应的固件变体名。若板子在 manifest 中检索不到,说明没有现成固件,直接烧录其他板的程序可能无法运行,需走「自定义开发板」路线。选择依据见「板卡与固件变体怎么选」。
  2. 下固件:到官方发布页下载与板型对应的固件 ZIP,面包板 Wi-Fi 方案对应 bread-compact-wifi 系列变体,加 ML307R 4G 模组的方案对应 bread-compact-ml307;解压得到 merged-binary.bin。预期结果:本地硬盘上有一个与板型匹配的 bin 文件,且存放路径不含中文字符——官方教程提示中文路径可能导致无法加载烧录。
  3. 烧录:方式一用 Flash Download Tool 3.9.7,芯片类型选 ESP32-S3、工作模式 Develop、加载模式 UART(开发板正面 TypeC 接口朝下时,右边为 UART 口),导入 bin 后勾选文件复选框、地址填 0x0,按设备管理器里识别出的 COM 端口选择端口,点 START;方式二用 Chrome 或 Edge 浏览器打开 https://espressif.github.io/esp-launchpad/ ,在 DIY 页点 Connect 选 COM,网页显示 Connected to device: ESP32-S3 后加载 bin、Flash Address 填 0x0、点 Program。预期结果:桌面工具进度条走完显示 FINISH,网页 Console 显示 100% 与 Leaving...;随后按 RST(网页方式点 Reset Device 再点 Confirm)重启设备。没有识别出 COM 口时,先换一根数据线,再查串口驱动(ESP32-S3 开发板常见 CH340/CH343 芯片驱动);仍连不上可用「按住 BOOT 不放,按 RST 约 0.5s,再松开 BOOT」进入烧录模式重试。展开见「免开发环境固件烧录」。
  4. 配网:保持通电,按 RST 复位进入配网,sRGB 彩灯蓝色持续闪烁即配网状态。用手机或电脑连接 Xiaozhi-XXXX 热点,未自动跳转时在浏览器输入 http://192.168.4.1 ;在扫描出的 2.4G 网络列表里选中自己的 Wi-Fi(名称自动填写,不用手输 SSID),输入密码点「连接」;扫描页打开慢时等约 5 秒勿关闭,iPhone 热点需打开「最大兼容性」。预期结果:页面显示登录成功标志,设备 3 秒后自动重启并连上刚配置的 Wi-Fi。重新配网见「Wi-Fi 配网与重新配网」专页。
  5. 激活:设备联网后通过「你好,小智」唤醒(不带离线唤醒的 ESP32-C3 等设备用按键唤醒),设备会播报或显示要求添加设备的 6 位设备验证码,可重复唤醒重听。电脑浏览器访问 https://xiaozhi.me ,未注册先注册;在页面左侧导航下方点「+新建智能体」,在智能体模块上点「添加设备」,输入提示语告知的 6 位数字设备 ID 后点「添加设备」;已添加过设备则从「设备管理」右侧的「+添加设备」进入。预期结果:设备自动激活并出现在「设备管理」列表,一个智能体可绑定多个设备终端。展开见「设备激活与管理后台配置」。
  6. 唤醒对话:对设备说出唤醒词开始对话,一问一答即完成首次对话。默认唤醒词存在官方口径冲突:官方 Q&A 写默认唤醒词是「你好小智」,并注明「小智你好」与「小智小智」均非正确唤醒词;官方 FAQ 却写默认唤醒词为「小智小智」。以设备实机首次播报或屏幕提示为准。预期结果:设备应答你的问题,第一次对话完成。对话细节与状态灯含义见「第一次对话与验证」,异常情况见「故障排查」。

六步走完后,你就拥有一台接入 xiaozhi.me 官方服务器、可以自由对话的小智终端;想换角色、音色或大模型,登录 xiaozhi.me 控制台配置。卡在某一步时,先回对应专页核对步骤,再按「故障排查」页的分症状条目定位。

资料来源

  • 78/xiaozhi-esp32 官方 README
  • 小智 AI 官方教程

相关内容

FireBeetle 2 ESP32-P4小智AI桌面伴侣实践DFR1221圆屏适配小智AI:触摸修复与动态角色实践行空板K10变身AI PassPort:语音问答与猜谜互动实践行空板K10小智AI聊天机器人:固件烧录与配置实践语音指挥农夫自动寻路!行空板K10+MCP打造AI 3D农场实践AI健身助手 · 行空板K10+姿势识别实践