网络配置说明
本页说明小智设备能用哪些方式联网、Wi‑Fi 怎样配置，以及需要换网络时怎么办。首次通电后的完整流程（含激活码与绑定）见 首次启动：配网、激活与绑定。
联网方式
具体可用的方式取决于开发板硬件：
- Wi‑Fi：最常见的方式；
- 有线以太网和 USB RNDIS；
- Cat.1 4G 模组：ML307、EC801E 或 NT26。部分硬件支持 Wi‑Fi 与 4G 切换，切换方式因板而异，例如
yunliao-s3在启动过程或配网界面 1 秒内双击按键。
Wi‑Fi 配网方式
| 方式 | 说明 | 启用方法 |
|---|---|---|
| 热点配网（默认） | 设备开放热点 Xiaozhi-XXXX，手机连接后在网页中选择路由器并输入密码 | menuconfig 中 WiFi Configuration Method → Hotspot，默认开启 |
| BluFi（BLE） | 设备蓝牙名称为 Xiaozhi-Blufi，用 EspBlufi 等客户端发送 Wi‑Fi 信息 | 启用 ESP-BluFi 并关闭 Hotspot，详见 BluFi 配网指南 |
两种方式在同一固件中不能同时启用。热点配网的具体步骤见 首次启动。
网络要求
- 频段：多数芯片只使用 2.4 GHz；支持 5 GHz 的芯片（如 ESP32-C5）会自动选择频段。
- 保存数量：设备最多保存 10 个 Wi‑Fi。连接时，如果有多个同名路由器（例如 Mesh 网络），优先连接信号最强的一个。
- 连接超时：已保存的网络 60 秒内没连上，设备回到配网模式。
- 热点安全：配网热点是开放网络，没有密码，最多同时连接 4 台设备。请在可信环境中配网。
重新配网
设备已有保存的 Wi‑Fi 时，不会自动进入配网。需要换网络时：
- 在启动阶段按开发板的配网键。按键因板而异：
bread-compact-wifi单击 BOOT 键；其他开发板请查看main/boards/下对应目录的 README。 - 部分开发板提供名为
self.disp.network（“重新配网”）的 MCP 工具。 - 旧网络消失或密码变化时，设备连接 60 秒失败后会自动进入配网模式。
高级设置
配网页的「高级」选项卡可以设置 OTA 地址、Wi‑Fi 发射功率和 Wi‑Fi 休眠模式（OTA 地址与休眠两项由固件决定是否显示）。OTA 地址决定设备向哪台服务器请求版本和激活信息，请只填写你信任的服务器。
排查网络问题
先对照 首次启动 · 常见问题排查。仍无法联网时：
- 确认路由器使用 2.4 GHz，名称与密码无误；
- 让设备靠近路由器测试，排除信号和遮挡问题；
- 查看设备串口日志，确认连接失败的原因；
- 更多问题见 常见问题。
来源：78/xiaozhi-esp32 v2.5.2 的 README_zh.md、wifi_board.cc、docs/blufi_zh.md，以及配网组件 78/esp-wifi-connect。