小智AI.Dev · 开发者社区

小智 AI 使用与开发指南

查找开发板与固件,完成设备使用、自建服务和功能开发,按症状解决问题。

小智(xiaozhi-esp32)是跑在 ESP32 上的开源 AI 语音机器人固件。本站帮你选板卡、下固件、把设备跑起来,也能陪你把服务端、协议和功能开发做下去。

固件发布矩阵 · v2.5.2
154开发板目录
188固件变体
7芯片平台
发布于 2026-10-11 发布清单 ↗
进入固件下载
ESP-IDF 6.1.0 · source 49b4380

按任务开始

精选教程

从一块板到第一次对话

四步跑通主链;已有设备从第 2 步开始也行。

查看完整路线
  1. 选板卡 按芯片与用途挑选,或直接用面包板方案
  2. 烧固件 下载对应变体,免开发环境写入
  3. 配网激活 热点或 BluFi 联网,激活码绑定
  4. 开口对话 说出唤醒词,跑通第一次交互

板卡与固件一览

数据来自上游发布清单,逐变体対账后展示。

浏览板卡目录

设备做什么,服务端做什么

小智把语音交互拆成两端:设备负责听和说,识别与大模型在服务端。理解这个分工,选板、配网、自建服务端每一步都更清楚。

设备端 · ESP32

  • 唤醒词检测(离线)
  • 麦克风采集与 Opus 编码
  • 音频播放与屏幕表情
  • 设备端 MCP 工具(音量、屏幕、拍照)
选板卡与固件 →

服务端

  • 语音识别(ASR)
  • 大模型对话(LLM)
  • 语音合成(TTS)
  • 云端 MCP 扩展
自建服务端指南 →

设备默认连接官方服务;想自己掌控语音数据,可以自建服务端。 能力边界详解 →