小智 AI 聊天機器人是一款基于開源硬件的智能對話設備，由開發者“蝦哥”以 ?MIT 許可證發布，旨在幫助用戶入門 AI 硬件開發，將大語言模型（LLM）應用于實體設備中。

小智 AI 聊天機器人以 ?低成本、高可玩性? 降低了 AI 硬件的入門門檻，既可作為技術實驗平臺，也能成為日常智能伴侶。其模塊化設計允許用戶持續擴展功能（如 3D 打印外殼定制），是探索 AI 落地的理想載體。

以下是其核心特點及使用信息：

核心功能與技術亮點

1. ?多模態交互方式?
   • ?語音喚醒?：支持離線喚醒（ESP-SR 技術）和按鍵喚醒（BOOT 鍵點擊/長按），可實時打斷對話。
   • ?多語言識別?：覆蓋國語、粵語、英語、日語、韓語 5 種語言。
   • ?聲紋識別?：通過聲音特征區分用戶身份，提供個性化對話體驗。
2. ?智能對話引擎?
   • ?大模型支持?：可靈活接入阿里通義千問（Qwen）、深度求索（DeepSeek）、豆包（Doubao）、OpenAI 等主流 LLM。
   • ?短期記憶?：每輪對話后自動總結內容，保持上下文連貫性。
   • ?角色自定義?：用戶可配置提示詞、音色及性格，打造專屬 AI 伴侶（如學者、朋友等角色） 。
3. ?硬件與顯示擴展?
   • ?兼容多種開發板?：包括樂鑫 ESP32-S3、立創·實戰派 ESP32-S3、M5Stack CoreS3 等 。
   • ?實時信息展示?：通過 OLED/LCD 屏顯示對話內容、信號強度及 Emoji 表情。
   • ?雙網絡接入?：支持 Wi-Fi 和 4G（ML307 Cat.1 模塊），確保戶外使用穩定性

視頻介紹

[](https://github.com/78/xiaozhi-esp32#%E8%A7%86%E9%A2%91%E4%BB%8B%E7%BB%8D)

ESP32+SenseVoice+Qwen72B 打造你的 AI 聊天伴侶！【bilibili】

給小智裝上 DeepSeek 的聰明大腦【bilibili】

手工打造你的 AI 女友，新手入門教程【bilibili】

項目目的

[](https://github.com/78/xiaozhi-esp32#%E9%A1%B9%E7%9B%AE%E7%9B%AE%E7%9A%84)

本項目是由蝦哥開源的一個開源項目，以 MIT 許可證發布，允許任何人免費使用，并可以用于商業用途。

我們希望通過這個項目，能夠幫助更多人入門 AI 硬件開發，了解如何將當下飛速發展的大語言模型應用到實際的硬件設備中。無論你是對 AI 感興趣的學生，還是想要探索新技術的開發者，都可以通過這個項目獲得寶貴的學習經驗。

歡迎所有人參與到項目的開發和改進中來。如果你有任何想法或建議，請隨時提出 Issue 或加入群聊。

學習交流 QQ 群：376893254

已實現功能

[](https://github.com/78/xiaozhi-esp32#%E5%B7%B2%E5%AE%9E%E7%8E%B0%E5%8A%9F%E8%83%BD)

• Wi-Fi / ML307 Cat.1 4G
• BOOT 鍵喚醒和打斷，支持點擊和長按兩種觸發方式
• 離線語音喚醒 ESP-SR
• 流式語音對話（WebSocket 或 UDP 協議）
• 支持國語、粵語、英語、日語、韓語 5 種語言識別 SenseVoice
• 聲紋識別，識別是誰在喊 AI 的名字 3D Speaker
• 大模型 TTS（火山引擎 或 CosyVoice）
• 大模型 LLM（Qwen, DeepSeek, Doubao）
• 可配置的提示詞和音色（自定義角色）
• 短期記憶，每輪對話后自我總結
• OLED / LCD 顯示屏，顯示信號強弱或對話內容
• 支持 LCD 顯示圖片表情
• 支持多語言（中文、英文）

已支持的芯片平臺

[](https://github.com/78/xiaozhi-esp32#-%E5%B7%B2%E6%94%AF%E6%8C%81%E7%9A%84%E8%8A%AF%E7%89%87%E5%B9%B3%E5%8F%B0)

• ESP32-S3
• ESP32-C3
• ESP32-P4

硬件部分

[](https://github.com/78/xiaozhi-esp32#%E7%A1%AC%E4%BB%B6%E9%83%A8%E5%88%86)

面包板手工制作實踐

[](https://github.com/78/xiaozhi-esp32#%E9%9D%A2%E5%8C%85%E6%9D%BF%E6%89%8B%E5%B7%A5%E5%88%B6%E4%BD%9C%E5%AE%9E%E8%B7%B5)

詳見飛書文檔教程：

《小智 AI 聊天機器人百科全書》

面包板效果圖如下：

已支持的開源硬件

[](https://github.com/78/xiaozhi-esp32#%E5%B7%B2%E6%94%AF%E6%8C%81%E7%9A%84%E5%BC%80%E6%BA%90%E7%A1%AC%E4%BB%B6)

• 立創·實戰派 ESP32-S3 開發板
• 樂鑫 ESP32-S3-BOX3
• M5Stack CoreS3
• AtomS3R + Echo Base
• AtomMatrix + Echo Base
• 神奇按鈕 2.4
• 微雪電子 ESP32-S3-Touch-AMOLED-1.8
• LILYGO T-Circle-S3
• 蝦哥 Mini C3
• Moji 小智 AI 衍生版
• 璀璨·AI 吊墜
• 無名科技 Nologo-星智-1.54TFT
• SenseCAP Watcher

固件部分

[](https://github.com/78/xiaozhi-esp32#%E5%9B%BA%E4%BB%B6%E9%83%A8%E5%88%86)

免開發環境燒錄

[](https://github.com/78/xiaozhi-esp32#%E5%85%8D%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E7%83%A7%E5%BD%95)

新手第一次操作建議先不要搭建開發環境，直接使用免開發環境燒錄的固件。

固件默認接入 xiaozhi.me 官方服務器，目前個人用戶注冊賬號可以免費使用 Qwen 實時模型。

Flash 燒錄固件（無 IDF 開發環境）

開發環境

[](https://github.com/78/xiaozhi-esp32#%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83)

• Cursor 或 VSCode
• 安裝 ESP-IDF 插件，選擇 SDK 版本 5.3 或以上
• Linux 比 Windows 更好，編譯速度快，也免去驅動問題的困擾
• 使用 Google C++ 代碼風格，提交代碼時請確保符合規范

開發者文檔

[](https://github.com/78/xiaozhi-esp32#%E5%BC%80%E5%8F%91%E8%80%85%E6%96%87%E6%A1%A3)

• 開發板定制指南 - 學習如何為小智創建自定義開發板適配
• 物聯網控制模塊 - 了解如何通過 AI 語音控制物聯網設備

智能體配置

[](https://github.com/78/xiaozhi-esp32#%E6%99%BA%E8%83%BD%E4%BD%93%E9%85%8D%E7%BD%AE)

如果你已經擁有一個小智 AI 聊天機器人設備，可以登錄 xiaozhi.me 控制臺進行配置。

后臺操作視頻教程（舊版界面）

技術原理與私有化部署

[](https://github.com/78/xiaozhi-esp32#%E6%8A%80%E6%9C%AF%E5%8E%9F%E7%90%86%E4%B8%8E%E7%A7%81%E6%9C%89%E5%8C%96%E9%83%A8%E7%BD%B2)

一份詳細的 WebSocket 通信協議文檔
MCP 協議 通信協議

在個人電腦上部署服務器，可以參考另一位作者同樣以 MIT 許可證開源的項目 xiaozhi-esp32-server