xiaozhi-esp32 如何把一塊 ESP32 開發板變成 AI 語音助手完整上手指南【免費下載鏈接】xiaozhi-esp32An MCP-based chatbot | 一個基于MCP的聊天機器人項目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32xiaozhi-esp32 是一個開源的固件項目它把 ESP32 系列開發板變成能聽懂話、能對話、還能執行指令的 AI 語音聊天機器人固件跑在板子上大模型推理在云端完成個人用戶免費接入官方服務器即可體驗。它適合手里有 ESP32-S3 或 CoreS3 這類開發板、想動手做一個語音設備的電子愛好者也適合想研究嵌入式 AI 交互流程的開發者。喚醒、對話、控制一個固件就搞定把開發板插上電說出Hi 小智板子就會進入聆聽狀態你說完一句云端大模型Qwen、DeepSeek 等生成回復并以 Opus 音頻流的形式流式播出來。整個過程不需要你寫一行代碼固件里已經包含了完整的鏈路基于 ESP-SR 的離線語音喚醒喚醒詞識別發生在板子上還支持訓練自定義喚醒詞流式語音識別ASR→ 大模型語義理解 → 多語言語音合成TTS的回傳設備端 MCP 工具讓大模型反過來控制板子上的硬件比如音量、燈光、電機、GPIO屏幕端支持 OLED/LCD 表情顯示部分硬件還支持攝像頭視覺輸入。MCPModel Context Protocol在這里的作用可以理解成給 AI 和硬件之間定了一套普通話。過去想讓大模型控制某個設備要為每個設備單獨寫接口用了 MCP 之后設備端用同一套協議暴露能力云端 AI 按標準調用它新增功能就變成了新增一個工具而不是重寫通信邏輯。從克隆到出聲音開發環境只需要三條命令如果你不想先搭開發環境官方固件可以直接燒錄默認接入 xiaozhi.me 官方服務器注冊個人賬號即可免費使用 Qwen 實時模型。想自己編譯的話環境要求是 ESP-IDF 插件主線首選 v6.0.2v5.5 僅保留給少數標注了舊版兼容的硬件。git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32 cd xiaozhi-esp32 idf.py menuconfig進入 menuconfig 后第一件事是選擇你的開發板型號項目通過 Kconfig 把板卡、Wi-Fi 配網方式熱點或 BluFi、AI 服務參數都收斂在這一個界面里。選好后回到命令行idf.py build flash monitor首次啟動時用熱點配網把 Wi-Fi 交給設備之后就可以對著它說話了。編譯慢的話建議用 Linux 環境比 Windows 快很多也省掉串口驅動的麻煩。沒有現成設備用面包板方案從零接線手上只有一塊裸板和元件也能玩起來。倉庫里的面包板方案是最小成本路線ESP32 主控加麥克風、揚聲器和按鍵用杜邦線搭在面包板上即可接線圖直接看下面這張面包板配置對應 main/boards/ 目錄下的 bread-compact-wifi 等板卡定義里面的 config.json 聲明了每個外設占用的引腳這也是所有板卡適配的統一格式。搭好之后對話鏈路和成品硬件完全一致區別只在外觀。支持哪些硬件6 個芯片平臺、138 個板卡目錄選型前先看數字項目覆蓋 ESP32、ESP32-C3、ESP32-C5、ESP32-C6、ESP32-S3、ESP32-P4 共 6 個芯片平臺倉庫里維護著 138 個板卡目錄、171 個固件發布變體常見型號如 M5Stack CoreS3、樂鑫 ESP32-S3-BOX-3、LILYGO T-Circle-S3、微雪 ESP32-S3-Touch-AMOLED-1.8 都在其中另有 38 種界面語言可選語音提示缺失時會自動回退英文。網絡方面不只是 Wi-Fi固件同時支持有線以太網、USB RNDIS以及 ML307/EC801E、NT26 等 Cat.1 4G 模組部分硬件還能在 Wi-Fi 和 4G 之間切換——這意味著同一個固件既能放在書房也能帶到沒有 Wi-Fi 的現場。進階玩法換喚醒詞、加屏幕表情、擴展 MCP 工具出聲音只是起點項目把個性化做成了內置能力自定義喚醒詞通過 ESP-SR 訓練流程錄自己的短語替代默認的Hi 小智界面定制表情、字體、聊天背景都可以替換官方提供網頁端 Assets 生成器在線修改后打包進固件能力擴展云端 MCP 可以掛接智能家居控制、PC 桌面操作、知識搜索、郵件收發等工具設備端 MCP 則負責本地硬件控制兩邊共用同一套協議。想改硬件而不是軟件時自定義開發板指南 講清楚了新建一個板卡目錄需要哪些文件MCP 協議用法 和 設備端 MCP 交互流程 則分別說明云端工具怎么接入、設備端調用是怎么發生的。遇到 Wi-Fi 配不上、燒錄失敗這類問題先看 docs/ 目錄里的協議文檔WebSocket 與 MQTTUDP 兩套傳輸方案各有說明仍解決不了再到項目 Issue 區提問把芯片型號和日志帶上回復會快很多。【免費下載鏈接】xiaozhi-esp32An MCP-based chatbot | 一個基于MCP的聊天機器人項目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 xiaozhi-esp32 如何把一塊 ESP32 開發板變成 AI 語音助手：完整上手指南
xiaozhi-esp32 如何把一塊 ESP32 開發板變成 AI 語音助手完整上手指南【免費下載鏈接】xiaozhi-esp32An MCP-based chatbot | 一個基于MCP的聊天機器人項目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32xiaozhi-esp32 是一個開源的固件項目它把 ESP32 系列開發板變成能聽懂話、能對話、還能執行指令的 AI 語音聊天機器人固件跑在板子上大模型推理在云端完成個人用戶免費接入官方服務器即可體驗。它適合手里有 ESP32-S3 或 CoreS3 這類開發板、想動手做一個語音設備的電子愛好者也適合想研究嵌入式 AI 交互流程的開發者。喚醒、對話、控制一個固件就搞定把開發板插上電說出Hi 小智板子就會進入聆聽狀態你說完一句云端大模型Qwen、DeepSeek 等生成回復并以 Opus 音頻流的形式流式播出來。整個過程不需要你寫一行代碼固件里已經包含了完整的鏈路基于 ESP-SR 的離線語音喚醒喚醒詞識別發生在板子上還支持訓練自定義喚醒詞流式語音識別ASR→ 大模型語義理解 → 多語言語音合成TTS的回傳設備端 MCP 工具讓大模型反過來控制板子上的硬件比如音量、燈光、電機、GPIO屏幕端支持 OLED/LCD 表情顯示部分硬件還支持攝像頭視覺輸入。MCPModel Context Protocol在這里的作用可以理解成給 AI 和硬件之間定了一套普通話。過去想讓大模型控制某個設備要為每個設備單獨寫接口用了 MCP 之后設備端用同一套協議暴露能力云端 AI 按標準調用它新增功能就變成了新增一個工具而不是重寫通信邏輯。從克隆到出聲音開發環境只需要三條命令如果你不想先搭開發環境官方固件可以直接燒錄默認接入 xiaozhi.me 官方服務器注冊個人賬號即可免費使用 Qwen 實時模型。想自己編譯的話環境要求是 ESP-IDF 插件主線首選 v6.0.2v5.5 僅保留給少數標注了舊版兼容的硬件。git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32 cd xiaozhi-esp32 idf.py menuconfig進入 menuconfig 后第一件事是選擇你的開發板型號項目通過 Kconfig 把板卡、Wi-Fi 配網方式熱點或 BluFi、AI 服務參數都收斂在這一個界面里。選好后回到命令行idf.py build flash monitor首次啟動時用熱點配網把 Wi-Fi 交給設備之后就可以對著它說話了。編譯慢的話建議用 Linux 環境比 Windows 快很多也省掉串口驅動的麻煩。沒有現成設備用面包板方案從零接線手上只有一塊裸板和元件也能玩起來。倉庫里的面包板方案是最小成本路線ESP32 主控加麥克風、揚聲器和按鍵用杜邦線搭在面包板上即可接線圖直接看下面這張面包板配置對應 main/boards/ 目錄下的 bread-compact-wifi 等板卡定義里面的 config.json 聲明了每個外設占用的引腳這也是所有板卡適配的統一格式。搭好之后對話鏈路和成品硬件完全一致區別只在外觀。支持哪些硬件6 個芯片平臺、138 個板卡目錄選型前先看數字項目覆蓋 ESP32、ESP32-C3、ESP32-C5、ESP32-C6、ESP32-S3、ESP32-P4 共 6 個芯片平臺倉庫里維護著 138 個板卡目錄、171 個固件發布變體常見型號如 M5Stack CoreS3、樂鑫 ESP32-S3-BOX-3、LILYGO T-Circle-S3、微雪 ESP32-S3-Touch-AMOLED-1.8 都在其中另有 38 種界面語言可選語音提示缺失時會自動回退英文。網絡方面不只是 Wi-Fi固件同時支持有線以太網、USB RNDIS以及 ML307/EC801E、NT26 等 Cat.1 4G 模組部分硬件還能在 Wi-Fi 和 4G 之間切換——這意味著同一個固件既能放在書房也能帶到沒有 Wi-Fi 的現場。進階玩法換喚醒詞、加屏幕表情、擴展 MCP 工具出聲音只是起點項目把個性化做成了內置能力自定義喚醒詞通過 ESP-SR 訓練流程錄自己的短語替代默認的Hi 小智界面定制表情、字體、聊天背景都可以替換官方提供網頁端 Assets 生成器在線修改后打包進固件能力擴展云端 MCP 可以掛接智能家居控制、PC 桌面操作、知識搜索、郵件收發等工具設備端 MCP 則負責本地硬件控制兩邊共用同一套協議。想改硬件而不是軟件時自定義開發板指南 講清楚了新建一個板卡目錄需要哪些文件MCP 協議用法 和 設備端 MCP 交互流程 則分別說明云端工具怎么接入、設備端調用是怎么發生的。遇到 Wi-Fi 配不上、燒錄失敗這類問題先看 docs/ 目錄里的協議文檔WebSocket 與 MQTTUDP 兩套傳輸方案各有說明仍解決不了再到項目 Issue 區提問把芯片型號和日志帶上回復會快很多。【免費下載鏈接】xiaozhi-esp32An MCP-based chatbot | 一個基于MCP的聊天機器人項目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考