第一次对话与验证
固件烧录、Wi-Fi 配网、后台激活全部完成后,用一条从上电到听到回应的完整链路验证整机是否跑通。灯色含义按官方教程的 sRGB 状态灯说明整理,官方教程为早期固件口径,当前固件以 v2.5.2 发布包为准。这条链路把状态灯映射成逐项可核对的检查点:灯色与提示走到哪一步,流程就通到哪一步,也从哪一步开始定位问题。官方 sRGB 状态灯全表如下,可对照使用:
| 灯色表现 | 设备状态 |
|---|---|
| 通电后蓝色闪烁一次 | 正在连接 WiFi |
| 随后绿色闪烁一次 | 已连接到 WiFi,可被语音唤醒 |
| 蓝色保持长亮 | 正在进行 OTA 固件更新,网络好时通常一分钟内完成 |
| 蓝色一直闪烁 | 处于配网状态 |
| 唤醒后蓝色亮起 | 正在连接服务器 |
| 红色亮起 | 正在录音 |
| 绿色亮起 | 正在播放语音 |
开始前的状态确认:设备应已在后台完成登记激活,「设备管理」列表中能看到这台设备。如果还没激活,唤醒后设备播报的是要求添加设备的 6 位验证码提示语,不会进入正常对话,请先按「设备激活与管理后台配置」一页完成添加。
- 上电观察蓝色闪烁一次。通电后 sRGB 彩灯先蓝色闪烁一次,表示设备正在连接 WiFi。预期结果:看到蓝灯闪一次。若没出现:如果蓝色一直闪烁,表示设备处于配网状态,需要先完成配网;如果灯始终不亮,多为 RGB 灯座旁两个焊点未接通,设备仍可能在工作,可接串口工具看日志确认设备状态。
- 观察绿色闪烁一次。随后闪烁一次绿色,表示设备已经连接到 WiFi,此时可以被语音唤醒。预期结果:蓝闪一次后绿闪一次,之后灯静止等待唤醒。若随后转为蓝色保持长亮,表示正在进行 OTA 固件更新,网络好的情况下通常一分钟内完成,等待结束即可;若绿闪迟迟不出现,按「Wi-Fi 配网与重新配网」一页检查网络(设备仅支持 2.4G 频段,iPhone 热点需打开「最大兼容性」)。
- 说出唤醒词。预期结果:设备给出提示音或屏幕出现变化,进入可对话状态。若多次说唤醒词无反应:先按设备实机首次播报或屏幕提示的词核对(官方口径冲突见下文),再按「故障排查」一页的唤醒无反应条目检查麦克风接线与器件。
- 观察唤醒后蓝色亮起。语音唤醒后蓝色会亮起,表示设备正在连接服务器。预期结果:唤醒后蓝色亮起,随后进入录音状态。若没出现:检查当前网络是否可访问互联网,语音对话链路需要联网(见文末说明),路由器正常不代表设备一定拿到了外网权限。
- 开始说话,观察红色亮起。红色亮起表示设备正在录音。预期结果:说话期间红灯亮起。若说话没反应:查 INMP441 麦克风接线与器件,包括进声孔面朝上、VDD/GND 不能反接、可换备用麦克风交叉验证,详见「故障排查」页。
- 等待回答,观察绿色亮起。绿色亮起表示设备正在播放语音。预期结果:喇叭播出 AI 的回答,绿灯与播放同步。若喇叭无声:查喇叭正负极与功放接线;3W 喇叭用电脑 USB 口供电可能出现供电不足,改 5V2A 及以上充电头或 5V2.1A 充电宝供电。
- 听到回应即跑通。能听到 AI 对你所说内容作出回答,说明配网、激活、录音上传、云端识别与生成、语音合成、播放整条链路全部工作正常,可以进入日常使用与个性化配置。
唤醒词的官方口径冲突需要如实交代,两处官方口径互相矛盾,任何一方都不宜直接照抄成结论:
| 来源 | 原文口径 |
|---|---|
| 官方 Q&A | 「唤醒词默认是 你好小智,请确认是否正确(不是 小智你好 或 小智小智,也不是配置的角色名字)」 |
| 官方 FAQ | 「默认唤醒词为'小智小智'」 |
可操作的结论:以设备实机首次播报或屏幕提示为准,先按设备提示的词试,不要照第三方教程猜。第三方教程把唤醒词写成角色名或其他说法时,照抄往往就是唤醒失败的直接原因。另注意,角色名字与唤醒词无关,在后台修改角色名不会改变唤醒词。
联网与模型口径:唤醒功能本身基于 ESP-SR 在设备端本地运行,官方 FAQ 明确「唤醒功能在设备端本地运行,无需联网」;但语音对话链路需要联网——按官方 README,固件默认接入 xiaozhi.me 官方服务器,传输走 WebSocket 或 MQTT+UDP 两种方式之一,音频采用 Opus 编码,既支持传统的流式 ASR + LLM + TTS 方案,也支持 Realtime 端到端语音模型,识别、生成与语音合成在云端完成,所以这套语音链路不能「完全离线使用」。
个人用户注册账号可以免费使用 Qwen 实时模型(按 2026-11-12 抓取的官方 main 分支 README 口径,具体额度以控制台当前说明为准)。
联网方式也不限于 Wi-Fi:按官方 README,固件支持 Wi-Fi、有线以太网、USB RNDIS 以及 ML307/EC801E 或 NT26 Cat.1 4G 网络,无论哪种接入,只要设备能访问互联网,本页验证链同样适用。
两个容易误判的现象:听到的提示音是英文——项目提供 38 种界面语言,语音提示优先使用本地化资源,缺失时自动回退英文,属于正常回退,不代表故障;对话能不能边说边听——具备 AEC 的硬件可实现实时全双工交互,是否支持取决于硬件配置。