生态项目：服务端、客户端与移植方案
小智的设备固件、通信协议和服务端是分开的：只要实现了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。