網路設定說明
本頁說明小智裝置能用哪些方式連網、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.md，以及配網元件 78/esp-wifi-connect。