小智 AI Wi-Fi 配网与重新配网
固件烧录完成后，设备要先配置 Wi-Fi 才能联网使用。本页按官方《配置设备 Wi-Fi 和添加设备》教程整理。官方教程为早期固件口径，当前固件以 v2.5.2 发布包为准（按 2026-11-12 抓取的官方 main 分支 / v2.5.2 发布包），配网流程同样适用。
ML307R-4G 版本的设备插上 SIM 卡/流量卡（物联网卡）即可联网，不需要走本页的 Wi-Fi 配网流程；无 WiFi 的户外环境也可使用手机热点。
一、首次配网步骤
- 复位进配网：烧录完成后保持设备接通电源，按下开发板上的 RST 按钮复位重启设备。预期结果：设备进入配网模式，sRGB 彩灯（开发板上的白色灯）呈蓝色并保持闪烁，表示设备处于配网状态。
- 连接热点：用手机或电脑连接设备发出的 WiFi 网络，名称通常以 Xiaozhi-XXXX 命名。预期结果：等待几秒热点连接成功后自动进入选择界面，请勿提前手动关闭界面。
- 打开配置页：若程序没有自动打开浏览器，在保持无线网络连着 Xiaozhi-XXXXXX、不要切换的前提下，用浏览器地址栏输入 http://192.168.4.1 进入设备的网络配置页面。预期结果：打开配网页面。
- 选择 WiFi：在小智热点扫描到的 2.4G 网络中，选择自己家或办公室的 WiFi（不用手动输入 WiFi 名称 SSID，选中名称后会自动填写）。打开扫描页面会有点慢，请等待 5 秒左右，勿取消或关闭页面。预期结果：扫描列表出现自己的 WiFi 名称并自动填入。
- 填密码并点「连接」按钮提交（手机已保存过的密码会自动提交）。注意仅支持 2.4G 网络，iPhone 热点要打开「最大兼容性」选项；需二次认证身份的校园网、商业场所网络，ESP32 的 WiFi 模块默认连接不上。预期结果：WiFi 名称和密码正确时，设备自动连接到 WiFi 并显示「登录」成功标志，表示已经配置网络成功，设备将在 3 秒后自动重启；重新启动后设备自动连接刚才配置的 WiFi。若配置失败，检查 WiFi 名称和密码是否正确，或尝试重新配置。
若 sRGB 彩灯一直不亮，或灯不是闪蓝色、拿不准设备是否真的在配网状态，可用串口工具查看开发板输出日志来定位；没有焊接 RGB 灯的设备也能配网，只是看不到状态提示。
二、重新配网的三种方式
设备不在配网状态或需要重新配网时，按固件版本选择对应方式：
- 较新固件：设备开机后直接按住 boot 按键，设备将重新配网，不再连接上次的 WiFi 网络。
- 固件版本 >=0.2.2：重试 3 次连接原有 WiFi 网络失败后，会重新进入配网模式（切换网络时可能需要按 RST 按键重启一下设备）。
- v0.2.2 以下旧版：按住设备上的配网按键（连接 1 号引脚和 GND），同时按下开发板上的复位（RST）按键，然后先松开复位按键，再松开配网按键。
设备默认只记住上次连接的 WiFi 及密码，更换 WiFi 或 WiFi/热点关闭时需要重新配置网络；要记住更多 WiFi 需另行实现代码程序。配网成功并自动重启后，设备会连接刚配置的 WiFi，随后可进入设备激活流程。
三、sRGB 状态灯含义
- 通电后先蓝色闪烁一次：设备正在连接 WiFi。
- 随后闪烁一次绿色：已连接到 WiFi，此时可以被语音唤醒。
- 通电后蓝色闪烁一次、然后蓝色保持长亮：正在进行 OTA 固件更新，通常网络好的情况下一分钟内完成。
- 通电后蓝色一直闪烁：设备处于配网状态。
- 语音唤醒后蓝色亮起：正在连接服务器。
- 绿色亮起：正在播放语音。
- 红色亮起：正在录音。
如果 sRGB 彩灯一直不亮，多为 RGB 灯焊点未接通：设备虽能使用、也不影响配网，但看不到配网与对话状态，建议用电烙铁焊锡接通灯座旁的两个焊点（可找维修手机或电脑的店家代焊）。排查线路时可断电后拔下所有模块，直接给 ESP32-S3 开发板上电看是否正常闪烁蓝色彩灯，确认线路连接正确后再联网测试。
四、找不到 Xiaozhi-xxx 热点
现象：配网时有提示音或屏幕显示已进入配网状态，但手机或电脑搜索不到 Xiaozhi-xxx 名称的 WiFi。
- 核对点：先确认 ESP32-S3 开发板的 WiFi 固件烧录成功：重启之后配网时，开发板上白色内圈圆形的 RGB 彩灯应为匀速闪蓝；没有焊接 RGB 灯或不是闪蓝灯、不确定的话，可以用串口工具看一下日志。
- 原因判断：确认程序烧录没有问题后仍遇到 WiFi 信号不稳定甚至连接不上，可能是部分商家的产品批次存在质量问题（非乐鑫官方 ESP32-S3 模组）。
- 官方建议方案：放置线圈——用软导线围绕开发板上 ESP32-S3 模块的天线位置缠绕 3 圈左右，增强天线的信号接收效果。
- 临时应对——靠近 WiFi 路由器信号较好的位置，或临时用手触摸天线位置完成连网。