小智AI韌體下載
小智AI 官方韌體透過 78/xiaozhi-esp32 的 GitHub Releases 發布。第一次上手建議直接燒錄預編譯韌體，不必先建置開發環境。
最新版本：v2.5.2
v2.5.2 發布於 2026-10-11，由 GitHub Actions 對整個發布矩陣統一建置：
- 188 個韌體變體，涵蓋 154 個開發板目錄；
- 使用 ESP-IDF 6.1.0 建置；
- 晶片平台包括 ESP32、ESP32-C3、ESP32-C5、ESP32-C6、ESP32-S3、ESP32-S31 和 ESP32-P4。
完整的更新列表見 v2.5.2 發布頁。
發布包內容
每個變體對應一個壓縮檔，命名規則為 v<版本>_<變體名>.zip，例如 v2.5.2_bread-compact-wifi.zip。壓縮檔內只有一個檔案：
merged-binary.bin：完整的 Flash 映像（含引導程式、分區表與應用程式），整體寫入 Flash 起始位址0x0。
發布頁另附兩個檔案：
SHA256SUMS：全部壓縮檔的 SHA-256 校驗值；release-manifest.json：建置來源 commit、ESP-IDF 版本與完整變體清單（含每個變體的晶片型號）。
選擇開發板對應的變體
變體名由「廠商-板卡[-螢幕/網路/版本]」組成，與上游倉庫 main/boards/ 下的目錄對應。麵包板方案中，ml307 表示 ML307 4G 版本，128x64 表示 OLED 解析度，lcd 表示 LCD 螢幕版本。
下表列出常見開發板，完整清單以發布頁附件與 release-manifest.json 為準；依晶片分組的全部 154 個開發板目錄、188 個變體見支援的開發板。
| 開發板 | 晶片 | 變體名 |
|---|---|---|
| 麵包板新版接線（Wi-Fi） | ESP32-S3 | bread-compact-wifi |
| 麵包板新版接線（Wi-Fi，OLED 128x64） | ESP32-S3 | bread-compact-wifi-128x64 |
| 麵包板新版接線（Wi-Fi，LCD） | ESP32-S3 | bread-compact-wifi-lcd |
| 麵包板新版接線（ML307 4G） | ESP32-S3 | bread-compact-ml307 |
| 麵包板 ESP32 DevKit | ESP32 | bread-compact-esp32 |
| 蝦哥 Mini C3 | ESP32-C3 | xmini-c3、xmini-c3-v3、xmini-c3-4g |
| 立創·實戰派 ESP32-S3 | ESP32-S3 | lckfb-lichuang-dev |
| 立創·實戰派 ESP32-C3 | ESP32-C3 | lckfb-lichuang-c3-dev |
| M5Stack CoreS3 | ESP32-S3 | m5stack-core-s3 |
| M5Stack AtomS3R + Echo Base | ESP32-S3 | m5stack-atoms3r-echo-base |
| 樂鑫 ESP-BOX-3 | ESP32-S3 | espressif-esp-box-3 |
| 樂鑫 ESP-BOX / ESP-BOX-Lite | ESP32-S3 | espressif-esp-box、espressif-esp-box-lite |
| 樂鑫 ESP-SparkBot | ESP32-S3 | espressif-esp-sparkbot |
| 樂鑫 ESP-VoCat | ESP32-S3 | espressif-esp-vocat |
| 神奇按鈕 Magiclick 2.4 / 2.5 | ESP32-S3 | magiclick-2p4、magiclick-2p5 |
| 神奇按鈕 Magiclick C3 / C3 v2 | ESP32-C3 | magiclick-c3、magiclick-c3-v2 |
| Kevin Box 2 | ESP32-S3 | kevin-box-2 |
| 無名科技星智 0.96 OLED（Wi-Fi） | ESP32-S3 | nologo-xingzhi-cube-0.96oled-wifi |
| 無名科技星智 1.54 TFT（Wi-Fi） | ESP32-S3 | nologo-xingzhi-cube-1.54tft-wifi |
| Seeed Studio SenseCAP Watcher | ESP32-S3 | sensecap-watcher |
| DFRobot 行空板 K10 | ESP32-S3 | dfrobot-df-k10 |
| LILYGO T-Circle-S3 | ESP32-S3 | lilygo-t-circle-s3 |
| 正點原子 DNESP32S3 / DNESP32S3-BOX | ESP32-S3 | alientek-atk-dnesp32s3、alientek-atk-dnesp32s3-box |
| Movecall Moji | ESP32-S3 | movecall-moji-esp32s3 |
| 微雪 ESP32-S3-Touch-AMOLED-1.8 | ESP32-S3 | waveshare-esp32-s3-touch-amoled-1.8 |
| 微雪 ESP32-S3-Touch-LCD-1.85 | ESP32-S3 | waveshare-esp32-s3-touch-lcd-1.85 |
燒錄韌體
方式一：免開發環境燒錄
依照上游維護的 新手燒錄韌體教學 操作，無需安裝 ESP-IDF。
方式二：使用 esptool 命令列
- 從發布頁下載對應變體的壓縮檔並解壓，得到
merged-binary.bin； - 以資料線連接開發板，必要時讓開發板進入下載模式；
- 將映像寫入位址
0x0：
# Install esptool (requires Python)
pip install esptool
# Write the merged image at 0x0 (replace the serial port with your own)
esptool.py -b 460800 write_flash -z 0x0 merged-binary.bin序列埠名稱因系統而異：Linux 常見為 /dev/ttyACM0 或 /dev/ttyUSB0，macOS 常見為 /dev/cu.usbmodem*，Windows 為 COMx。需要手動指定時使用 -p <序列埠>。部分開發板另有專用的 Flash 參數說明，請參考上游倉庫中該開發板目錄下的 README。
驗證下載檔案
將壓縮檔與 SHA256SUMS 下載到同一目錄後，驗證已下載的檔案：
# Linux
sha256sum -c SHA256SUMS --ignore-missing
# macOS
shasum -a 256 -c SHA256SUMS --ignore-missing自行編譯
沒有找到對應開發板、需要修改設定，或想適配自己的硬體時，可以自行編譯：
- 建置 ESP-IDF 開發環境：韌體要求 ESP-IDF v6.0.1 以上，建議使用
release/v6.1分支； - 使用上游腳本一次建置並封裝：
python scripts/build.py <板卡名> --zip。
伺服器與帳號
官方韌體預設連接官方伺服器，個人使用者註冊帳號後可免費使用 Qwen 即時模型，裝置設定請登入官方控制台（入口見上游 README）。如需連接自建服務端，請先閱讀自架伺服器；社群服務端專案見生態專案。
來源：78/xiaozhi-esp32 GitHub Releases 與上游 README_zh.md、docs/releasing.md。