生態專案:服務端、客戶端與移植方案
小智的裝置韌體、通訊協議和服務端是分開的:只要實現了WebSocket或 MQTT + UDP 協議,就可以替換其中任何一環。圍繞這套協議,社群出現了一批第三方開源專案。
本頁的名單來自上游韌體 README 的「相關開源專案」,並逐個核對了儲存庫狀態、授權條款和首頁描述(核對日期 2026-10-23)。這些專案由各自作者維護,不屬於本站,也不屬於上游韌體儲存庫;收錄不代表背書,使用前請自行評估功能、安全性和授權條款。
一、服務端
在自己的電腦或伺服器上執行後端,讓裝置改連你的伺服器。接入步驟與安全警示見自建服務端。
| 專案 | 技術形態 | 授權條款 | 概要 |
|---|---|---|---|
| xinnan-tech/xiaozhi-esp32-server | Python + Java + Vue | MIT | 支援 MQTT + UDP、WebSocket、MCP 接入點、聲紋識別、知識庫,有智控台 |
| joey-zhou/xiaozhi-esp32-server-java | Java(Spring Boot) | MIT | 企業級管理平台,管理後台與對話服務分為兩個行程 |
| AnimeAIChat/xiaozhi-server-go | Go | 修改版 Apache 2.0,含附加條件 | 面向個人和家庭場景;附加條件包括未經書面授權不得用於多租戶,使用前請閱讀其 LICENSE |
| hackers365/xiaozhi-esp32-server-golang | Go | MIT | 全流式 ASR → LLM → TTS,支援 WebSocket 與 MQTT + UDP |
二、客戶端與移植方案
使用小智通訊協議的非 ESP32 終端。
| 專案 | 平台 | 授權條款 | 概要 |
|---|---|---|---|
| huangjunsen0406/py-xiaozhi | Python,跨平台 | MIT | 基於非同步架構的多模態互動框架,支援實時語音、視覺任務和 IoT 裝置控制 |
| TOM88812/xiaozhi-android-client | Flutter(Android、iOS、HarmonyOS、Web、桌面) | Apache-2.0 | 基於小智的實時語音對話應用,可連線 xiaozhi-server |
| 100askTeam/xiaozhi-linux | 嵌入式 Linux | 儲存庫未宣告授權條款 | Linux 小智核心程式碼,不含各單板的 BSP 驅動;已適配的單板列表見其 README |
| 78/xiaozhi-sf32 | 思澈 SF32 藍牙晶片 | MIT | 聯網基於藍牙 PAN 協議,採用 OPUS 編解碼,支援裝置端 MCP |
| QuecPython/solution-xiaozhiAI | 移遠 QuecPython 模組 | 儲存庫未宣告授權條款 | 基於 WebSocket 協議,範例開發板使用 EC800MCNLE 模組 |
三、選型提示
- 先確認協議版本:這些專案各自實現通訊協議,欄位與行為可能與你手上的韌體版本不完全一致,以協議文件為準對照。
- 先讀授權條款:多數專案為 MIT 或 Apache-2.0,也有專案附加了條件,或沒有宣告授權條款;商用前務必確認。
- 看維護狀態:檢視儲存庫的最近提交與 Issues,而不是隻看 star 數。
- 注意安全:第三方服務端和客戶端都會接觸裝置標識與語音資料,見自建服務端的安全警示。
四、更正與補充
名單有錯誤或需要補充時,請發郵件到 [email protected],並附上儲存庫位址和授權條款說明。韌體本身的問題請到上游 GitHub Issues 反饋。
相關文檔
- 自建服務端:讓裝置連線你自己的伺服器
- WebSocket 通訊協議、MQTT + UDP 混合協議、MCP 協議
- 自訂開發板指南
對照來源:上游 78/xiaozhi-esp32 v2.5.2 的 README_zh.md「相關開源專案」,以及各儲存庫 README 與 LICENSE,核對日期 2026-10-23。