xiaozhi-android-client

用 Flutter 打通双端，快速接入小智语音助手

小智 Android 客户端是一个基于小智和 xiaozhi-server 的跨平台语音对话应用，使用 Flutter 开发，同时支持 Android 和 iOS。它解决了在移动端快速接入小智语音助手服务的问题，提供实时语音交互和文字对话两种模式。核心能力包括：对接小智后端服务，实现流畅的语音识别与合成；支持多轮对话，可接入 Dify 等平台扩展智能体能力；通过 Flutter 实现一套代码双端运行，降低开发成本。项目处于成长阶段，社区活跃，适合开发者二次开发或集成到自己的智能硬件、App 中。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1598

维护状态活跃

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队TOM88812

所属国家

官网地址https://jtai.lhht.cc

GitHubhttps://github.com/TOM88812/xiaozhi-android-client

定价模式free

价格说明开源项目，免费使用，无付费版本。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Dart

技术栈/模型ai,chat,chatbot,chatgpt,dart,dify,flutter,xiaozhi

GitHub 星标★ 1598

30天Star增速

HF 下载量

上线时间2025-02-23 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：进阶约 30 分钟部署方式：本地安装 6 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Flutter 开发环境（项目基于 Flutter 框架，README 未给出具体版本号）
Android 或 iOS 构建环境（Android Studio / Xcode，用于打包双端）
可访问的小智服务端 xiaozhi-server（项目基于 WebSocket 与后端通信）
Git（用于克隆仓库）

安装与启动步骤

1克隆项目仓库

从 GitHub 拉取源码到本地，README 未说明安装步骤，此处使用仓库地址克隆。
```
git clone https://github.com/TOM88812/xiaozhi-android-client.git
```
2进入项目目录

切换到克隆下来的项目根目录，后续 Flutter 命令都在此目录执行。
```
cd xiaozhi-android-client
```
3拉取依赖

使用 Flutter 拉取项目依赖（README 未写明命令，属 Flutter 项目通用流程，如失败以仓库说明为准）。
```
flutter pub get
```
4准备服务端

需自行准备并可访问小智服务端（xiaozhi-server）；README 提供了服务端图形化部署工具的参考链接。
5运行或打包

用 Flutter 在真机/模拟器运行，或打包 Android/iOS 安装包；README 未给出具体打包参数。
```
flutter run
```
6直接下载体验包

不想自行编译，可从 GitHub Releases 页面下载作者发布的安装包直接体验，参考 Wiki 与 demo 视频。

如何确认成功

应用启动后能与小智服务端建立 WebSocket 连接，语音对话或文字对话可正常收发回复。

常见问题

Q：没有 Flutter 开发环境能使用吗？

A：可以。README 指向 GitHub Releases 页面提供已打包版本，直接下载安装即可体验，无需自行编译源码。

Q：除了 Android 还支持哪些平台？

A：项目基于 Flutter 开发，README 说明支持 iOS、Android、Web、Windows、macOS、Linux 多平台，可自行打包 PC 或 Web 版本。

Q：如何接入 Dify 或其他智能体？

A：README 提到已支持 Dify 发送图片交互，并可添加多个小智智能体到聊天列表，具体参数需按你的服务端配置填写。

Q：服务端怎么部署？

A：README 给出了服务端图形化部署工具的参考链接（B 站空间与 znhblog.com），具体步骤请参考该教程与官方 Wiki。

注意事项

README 节选中未提供完整的安装、编译与配置说明，Flutter 相关命令为项目通用流程推断，请以仓库最新 README 和 Wiki（https://wiki.lhht.cc）为准。
语音对话需依赖可用的 xiaozhi-server 服务端，客户端本身不包含后端能力。
iOS 与 Android 的回音消除已实现，实时语音体验受设备麦克风与权限设置影响。
项目仍在持续更新，建议优先使用 Releases 中的最新版本。

核心亮点

跨平台：Flutter 实现 Android 和 iOS 双端支持，一套代码节省开发成本
实时语音交互：基于小智服务，支持低延迟语音对话，体验流畅
可扩展性强：支持接入 Dify 等平台，方便定制智能体功能

不足之处

依赖后端服务：功能强依赖 xiaozhi-server，独立使用受限
文档/社区待观察：项目成长中，文档和社区支持可能不够完善

适用场景

智能硬件配套 App：为小智设备提供移动端控制与对话界面
语音助手二次开发：开发者基于此快速构建自定义语音助手应用
跨平台应用开发：学习 Flutter 在语音交互场景的实践案例

替代项目

Home Assistant、Mycroft、Rhasspy

项目介绍

xiaozhi-android-client 是对话助手领域的开源项目，由 TOM88812 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,598）位列前 30%，在对话助手分类的 905 个项目里位列前 15%。

近 45 天，它的 GitHub 星标从 1,563 增加到 1,598，净增 35。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。免费使用，无付费版本。从国内网络环境看，可直接访问。

它主要面向的使用场景是：智能硬件配套App：为小智设备提供移动端控制与对话界面。同类可对比的替代方案包括 Home Assistant、Mycroft、Rhasspy。

上一篇：Risuai

下一篇：bots