xiaozhi-android-client

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

开源 🏷️完全免费 ✅ 目前可打开对话助手 🍴 复刻 424 🐛 待处理 7 👀 关注 19

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1662

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源项目，免费使用，无付费版本。

项目预览

xiaozhi-android-client 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类对话助手

开发团队TOM88812

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

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

定价模式🏷️完全免费

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

访问状态✅ 目前可打开

是否开源是

开源协议Apache-2.0

主要语言Dart

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

GitHub 星标★ 1662

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

代码更新2026-09-18

仓库体积5.4 MB

本站数据更新2026-11-08

维护状态维护中

收录时间2026-08-09

浏览次数5

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1662

技术标签

ai chat chatbot chatgpt dart

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：进阶约 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 中的最新版本。