如何用30分鐘打造一臺會說會答的ESP32 AI聊天機器人xiaozhi-esp32 完整上手指南與新手清單【免費下載鏈接】xiaozhi-esp32An MCP-based chatbot | 一個基于MCP的聊天機器人項目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32xiaozhi-esp32 是一款開源的 ESP32 AI 語音聊天機器人語音喚醒、大模型對話、語音應(yīng)答一站式打通還能通過 MCP 協(xié)議控制燈光、電機和 GPIO。燒錄一份固件你就得到一位能對話的語音助手。這個項目替你解決了什么 這一節(jié)幫你在動手前先判斷它適不適合你的需求。AI 硬件新手不用從零寫喚醒、ASR、TTS 協(xié)議燒錄現(xiàn)成固件就能體驗語音 大模型的完整鏈路創(chuàng)客玩家手里的 ESP32-S3 / C3 開發(fā)板可以直接變成一臺會聊天的桌面設(shè)備在校學(xué)生把離線喚醒 → 流式識別 → 大模型 → 語音合成整條流水線當(dāng)活教材硬件小團(tuán)隊倉庫覆蓋138 個板卡目錄、171 個固件變體可直接當(dāng)作移植參考實現(xiàn)它背后的思路很簡單設(shè)備端負(fù)責(zé)聽和說大模型負(fù)責(zé)思考而 MCPModel Context Protocol 讓 AI 還能反過來指揮設(shè)備本身。開工清單硬件、軟件、網(wǎng)絡(luò)一張表這一節(jié)把三要素合并成一張清單照著勾選就能開工避免裝到一半發(fā)現(xiàn)缺東西。類別必備項建議說明硬件ESP32 開發(fā)板ESP32-S3 優(yōu)先也支持 C3 / C5 / C6 / P4 等平臺硬件I2S 數(shù)字麥克風(fēng) 小揚聲器各 1 個輸入輸出成品開發(fā)板通常已集成硬件顯示屏可選OLED / LCD用于顯示表情與狀態(tài)軟件操作系統(tǒng)Linux 優(yōu)先編譯更快免去驅(qū)動折騰軟件VSCode 或 Cursor ESP-IDF 插件IDF 首選v6.0.2新手可直接用預(yù)編譯固件跳過編譯環(huán)境網(wǎng)絡(luò)2.4GHz Wi-Fi信號穩(wěn)定配網(wǎng)與對話都依賴它兩個提醒主線已遷移到ESP-IDF v6.0v5.5 僅為舊版硬件保留版本選擇細(xì)節(jié)見 docs/esp-idf-6-migration.md。支持 ESP32、ESP32-C3/C5/C6、ESP32-S3、ESP32-P4 共 6 類芯片選板時留意芯片型號與固件匹配。最小可行路徑四步先跑通一次 ?這一節(jié)給你最短路線——目標(biāo)只有一個讓設(shè)備開口和你對話其余參數(shù)以后再調(diào)?？寺}庫git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32選擇板型你的板子在 main/boards/ 下有對應(yīng)目錄如樂鑫 esp32-s3-box-3、M5Stack core-s3、立創(chuàng)實戰(zhàn)派等就選它拿不準(zhǔn)就選官方推薦的預(yù)編譯固件變體。燒錄固件USB 連接開發(fā)板用免開發(fā)環(huán)境的燒錄方式如 docker/firmware-builder/ 或 ESP-IDF 插件選擇對應(yīng)變體一鍵燒錄。重要當(dāng)前 v2 分區(qū)表與 v1不兼容無法通過 OTA 互相升級。如果你手里是 v1 老硬件只能手動重新燒錄升級到 v2分區(qū)布局對比見 partitions/v2/README.md。配網(wǎng)并對話設(shè)備開機后走熱點或 BluFi 配網(wǎng)接入 Wi-Fi注冊一個官方賬號即可免費調(diào)用 Qwen 實時模型說出喚醒詞開始第一句對話。跑通這一步核心鏈路喚醒 → 識別 → 大模型 → 合成就已經(jīng)全部工作了。按需配置真正值得調(diào)的只有三項這一節(jié)只講關(guān)鍵參數(shù)怎么改不重復(fù)燒錄流程。喚醒詞基于 ESP-SR 實現(xiàn)離線喚醒支持自定義喚醒詞模型存放在assets分區(qū)可聯(lián)網(wǎng)更新無需重新燒錄。適合改一個順口的名字比如小智小智。Wi-Fi 配網(wǎng)內(nèi)置熱點與 BluFi 兩種方式后者走藍(lán)牙傳輸憑據(jù)適合不方便改配網(wǎng)邏輯的場景詳見 docs/blufi_zh.md。服務(wù)器固件默認(rèn)接入 xiaozhi.me 官方服務(wù)器注冊賬號后免費使用 Qwen 實時模型也可以自部署服務(wù)端替換通信層支持 WebSocket 與 MQTT UDP 兩種傳輸協(xié)議細(xì)節(jié)分別在 docs/websocket_zh.md 和 docs/mqtt-udp_zh.md。想改界面語言、字體、表情或聊天背景界面已內(nèi)置 38 種語言資源同樣走assets分區(qū)聯(lián)網(wǎng)更新。排錯手冊按癥狀對號入座 這一節(jié)把高頻問題整理成癥狀 → 原因 → 解法出問題時先查表再動手。癥狀可能原因解法Wi-Fi 連不上SSID / 密碼錯誤或用了 5GHz 頻段核對賬號密碼路由器單獨開啟 2.4GHz燒錄失敗、識別不到設(shè)備數(shù)據(jù)線只能充電、USB 驅(qū)動缺失換一根能傳數(shù)據(jù)的線Windows 下補裝驅(qū)動喚醒后沒有應(yīng)答未連上服務(wù)器、賬號未激活確認(rèn) Wi-Fi 已連接且官方賬號已注冊成功語音識別不穩(wěn)定環(huán)境噪聲大、麥克風(fēng)接線虛接換安靜環(huán)境測試檢查 I2S 麥克風(fēng)連接老設(shè)備 OTA 升級失敗v1 與 v2 分區(qū)表不兼容手動燒錄 v2 固件后再啟用 OTA喚醒詞不響應(yīng)自定義模型未下載到 assets 分區(qū)檢查網(wǎng)絡(luò)后重啟設(shè)備讓資源重新拉取排錯順序建議先電源、再網(wǎng)絡(luò)、后語音逐層往上查避免一上來就懷疑大模型。進(jìn)階玩法讓 AI 反過來指揮設(shè)備 ?這一節(jié)幫你把聊天玩具升級成可控設(shè)備也是這個項目最有延展性的部分。設(shè)備端 MCP設(shè)備通過McpServer::AddTool注冊工具大模型發(fā)現(xiàn)后可直接調(diào)用。音量、燈光、電機、GPIO 都是現(xiàn)成例子注冊寫法參考 main/mcp_server.cc完整用法見 docs/mcp-usage_zh.md。云端 MCP 擴展把能力從設(shè)備搬到云端——智能家居控制、PC 桌面操作、知識搜索、郵件收發(fā)讓對話變成辦事。二次開發(fā)方向新硬件適配照 docs/custom-board_zh.md 給自己的板子建一個目錄加入 main/boards/ 即可參與構(gòu)建矩陣通信層替換對照 docs/websocket_zh.md / docs/mqtt-udp_zh.md 自搭服務(wù)端資源定制字體、表情、喚醒詞模型都走assets分區(qū)改動后免燒錄直接生效收尾下一步往哪走小智把語音 大模型最難的協(xié)議層封裝成了固件你只需要關(guān)注兩件事選一塊板、說一句話。跑通最小路徑之后建議依次嘗試——換個喚醒詞、加一個自己的 MCP 工具、適配一塊新板卡。遇到問題優(yōu)先在倉庫提交 Issue 描述癥狀或直接加入項目 Discord / QQ 群1011329060提問想深入從 docs/mcp-protocol_zh.md 讀起理解設(shè)備端 MCP 的完整交互流程想貢獻(xiàn)項目以 MIT 許可開源商用自由板卡與語言包的 PR 都受歡迎每一塊 ESP32 都值得有一個能對話的靈魂現(xiàn)在就可以動手了?！久赓M下載鏈接】xiaozhi-esp32An MCP-based chatbot | 一個基于MCP的聊天機器人項目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考