小智 AI 聊天機器人文檔中心 | 小智AI.Dev
使用指南
小智AI常見問題解答

小智AI常見問題解答

為簡化表述，以下小智AI終端代指小智AI聊天機器人，除了ESP32-S3-WROOM-1系列開發板相關外，以下問題大部分針對麵包板配置方案，其他廠商的方案或定製的方案的問題不在此整理之列。韌體相關的回答對照上游 78/xiaozhi-esp32 v2.5.2 整理；涉及管理後臺 / 控制台的操作，以官方控制台頁面的實際提示為準。

基礎入門問題

Q0：小智AI機器人復刻操作步驟是怎樣的？

A：使用麵包板，或杜邦線，或自己焊接導線組裝方式，分以下5個步驟：

  1. 購買材料與模組：按照清單購買所需要的材料及模組，具體參考文件：硬體搭建指南（元件清單與接線）
  2. 硬體接線：根據使用者購買的開發板（44引腳或42引腳），選擇對應的接線圖或連線表格教程文件，按照對應英文及數字編號連線接好導線。
  3. 下載燒錄韌體：
    • 韌體檔名形如 v2.5.2_<變體名>.zip，以 GitHub Releases 為準；變體名在支援的開發板中查詢；
    • 麵包板 Wi-Fi 方案：bread-compact-wifi（0.91 寸 128×32 OLED），使用 128×64 螢幕選 bread-compact-wifi-128x64；
    • 麵包板 ML307 4G 方案（可選）：bread-compact-ml307（128×64 螢幕為 bread-compact-ml307-128x64）；
    • 燒錄工具和韌體下載：韌體下載
  4. 配置裝置聯網：
    • ESP32S3開發板預設支援WIFI網路，請配置您所在場所的WIFI或手機熱點（限2.4G頻段WIFI，不支援二次驗證的WIFI網路），配網方式見網路配置說明；
    • ML307R-4G版本插上SIM卡/流量卡（物聯網卡）即可聯網
  5. 登記裝置：聯網後裝置會顯示並朗讀啟用碼，到控制台輸入啟用碼完成綁定，詳見首次啟動。喚醒"你好小智"即可使用。

注意：

  • 第3步和第4步的WIFI配置，可以在硬體模組接線之前先操作
  • 購買第三方開發板或已經組裝好的產品，參考相關說明，一般無需接線，可以直接按對應韌體版本燒錄即可

Q1：我不會焊接電烙鐵，可以復刻小智AI聊天機器人嗎？

A：可以的，按照專案教程文件，使用麵包板配置WIFI方案，在購買時選擇焊接好的排針的電子元件模組，再按照文件步驟操作接線和下載韌體到開發板，配置WIFI網路和登記裝置後即可復刻小智AI聊天機器人，整個過程不需要使用到電烙鐵。

Q2：請問復刻小智AI的硬體材料及元件清單到哪裡看，到哪裡買？

A：

  1. 小智AI終端的硬體材料及模組清單，請參考硬體搭建指南中的元件清單與接線部分
  2. 關於購買連結，有以下幾種方式：
    • 散件：按模組的名稱搜尋，例如開發板搜尋"ESP32 S3 開發板"，麥克風搜尋"INMP441"，音訊功放搜尋"MAX98357"等
    • 組合套件：搜尋關鍵詞"小智AI ESP32"或"小智AI ESP32S3"等
    • 選購注意事項：參見硬體搭建指南

注意：由於商家產品存在差異，請儘量選擇信譽高銷量高評價好的店鋪購買，購買諮詢和售後品質問題請自行和商家協商。

Q3：請問我需要購買ML307R-4G模組嗎？

A：ML307R-4G模組是可選的，主要在以下情況使用：

  • 使用場所沒有WIFI或WIFI受限（如部分校園網、商業場所等需要二次認證身份的網路）
  • 非WIFI環境下，連線手機熱點不方便或使用者沒有智慧手機

結論：有正常WIFI或手機熱點可使用，不用購買ML307R-4G模組（不想連wifi或覺得連WIFI麻煩的，不在意流量費用成本就想使用4G流量的除外）。

補充：上游 README 列出的 Cat.1 4G 方案有 ML307、EC801E 和 NT26 三類模組，具體可用的開發板見支援的開發板。

韌體與燒錄問題

Q4：如何燒錄小智AI的韌體程式，報錯了怎麼辦？

A：請參考韌體下載與燒錄教程，關鍵點：

  1. 晶片型號選擇為ESP32-S3
  2. 載入模式預設UART，插開發板右側的USB介面（背面絲印對應COM）
  3. 燒錄的BIN檔案要勾選上，網址要填寫0或0x0
  4. COM埠請選擇自己電腦上識別的COM埠號

注意：

  • 請使用手機或開發板配置的TYPE-C資料線，不要使用細小的USB充電線
  • 燒錄的BIN檔案路徑裡不能包含中文字元，否則無法載入燒錄

Q5：IDF是什麼開發環境，我需要配置IDF開發環境嗎？

A：

  1. 普通使用者不需要安裝配置IDF開發環境，開發者或學習程式設計使用者才需要配置
  2. IDF是指ESP-IDF，是ESP32晶片公司樂鑫科技官方推出的開發平台，支援C/C++語言開發ESP32應用；v2.5.2 要求 ESP-IDF 6.0.1 及以上，推薦使用 release/v6.1 分支
  3. 如需配置：

硬體問題

Q6：我復刻的小智AI終端喇叭為什麼沒有聲音？

A：

  1. 檢查喇叭是否接好，一般紅色線為正極，黑色線為負極
  2. 檢查數字功放是否接對且接觸良好，參考接線表格
  3. 如使用電腦USB口供電，喇叭功率達到3W可能會供電不足，建議改用5V2A及以上的USB充電頭或5V2.1A的充電寶USB口供電

如確定接線正確仍無法解決，可更換備用喇叭和數字功放模組測試。

Q7：我復刻的小智AI終端喇叭有沙啞的聲音/聲音異常？

A：

  1. 喇叭有沙啞聲一般是數字功放GAIN沒有接地GND，或GND接線不穩定
  2. 喇叭中聲音有沙沙的電聲可能是電磁干擾，請將小智AI終端遠離強磁場裝置或模組，隔離充放電電源等

Q8：如何調整小智AI終端的音量大小？

A：

  1. 語音調節：大模型透過裝置端 MCP 工具 self.audio_speaker.set_volume 設定音量，直接說"把音量調整到多少"或"音量調小/調大一點"即可，見 MCP 使用說明
  2. 按鍵調節：bread-compact-wifi 麵包板方案在 config.h 中定義了音量按鍵，IO40 為音量加、IO39 為音量減；其他開發板的按鍵以各自目錄下的說明為準

Q9：為什麼小智AI終端"你好小智"無法喚醒/無反應？

A：

  1. 確認喚醒詞正確（“你好小智"而非"小智你好"或其他）
  2. 檢查麥克風6個引腳的接線是否正確且接觸良好
  3. 注意INMP441麥克風預設是有麥克風圖示和絲印字母帶進聲孔這一面朝上的
  4. 如接線正確仍無法解決，可更換備用麥克風測試
  5. 使用序列埠通訊工具檢查開發板輸出資訊也可幫助定位問題

Q10：小智AI終端提醒我配網，但是找不到Xiaozhi-XXXX熱點？

A：這說明ESP32S3開發板的WIFI訊號存在問題，可以：

  1. 臨時用手按住開發板天線位置或繞線嘗試增強天線訊號
  2. 使用序列埠工具檢查開發板輸出資訊，定位問題

Q11：小智AI如何重新配網WIFI/切換WIFI？

A：

  1. 將開發板重新上電/重啟，在啟動階段按開發板的配網鍵：bread-compact-wifi 單擊 BOOT 鍵，其他開發板請看對應目錄下的說明，進入配網模式
  2. 已儲存的 Wi-Fi 在 60 秒內沒有連上時，裝置也會自動進入配網模式
  3. 部分開發板提供名為 self.disp.network 的 MCP 工具（重新配網）

注意：裝置最多儲存 10 個 Wi-Fi，已有儲存的網路時不會自動進入配網；換網路需要按上述方式主動進入配網模式。詳見網路配置說明。

Q12：為什麼我的螢幕沒有點亮？

A：

  1. 檢查螢幕接線是否正確且接觸良好
  2. 麵包板品質有好壞，有問題時可以使用萬用表測試通聯情況
  3. 如確定接線正確仍無法解決，可更換備用螢幕測試

功能與使用問題

Q13：小智AI終端支援播放音樂嗎？

A：v2.5.2 韌體原始碼中沒有音樂播放功能，能否點歌取決於所接入的服務端，請以官方控制台或自建服務端的說明為準。需要播放本地音樂時，可以自行擴充硬體介面和程式碼，或在服務端對接第三方音樂平台。

Q14：小智AI終端支援DeepSeeK等大模型切換嗎？

A：支援，但由服務端決定。使用官方伺服器時，可選的模型和切換位置以官方控制台頁面為準（預設連線官方伺服器，個人使用者註冊賬號後可免費使用 Qwen 實時模型）；使用自建服務端時，在該服務端的配置中選擇模型，見自建服務端。裝置韌體本身不綁定具體模型。

Q15：小智AI終端支援藍牙連線嗎？

A：暫時不支援。

  • ESP32S3晶片/模組支援藍牙BLE從機模式（只支援被連線），小智AI韌體預設不使用該功能；僅在啟用 BluFi 配網時，BLE 才用於傳輸 Wi-Fi 憑據，詳見 BluFi 配網指南
  • 由於僅支援從機模式，小智AI終端不支援連線藍牙耳機或音箱

Q16：可以給小智AI終端的換更大的喇叭嗎？

A：可以的，目前小智AI終端預設的數字功放MAX98357支援3W左右的喇叭。如需更大功率，可換用其他支援I2S的功放模組，但注意ESP32開發板的USB供電一般不超過5W，更高功率需要另外單獨供電。

Q17：請問小智AI終端支援插耳機或者3.5MM的音訊孔輸出嗎？

A：預設不支援，需要更換音訊模組，如：

  • PCM5102音訊模組（支援立體聲DAC，約10元）
  • UDA1334A I2S立體聲解碼器（約13-15元）

上述解碼器都支援3.5MM音訊輸出，不需要改動程式程式碼。

Q18：可以給小智AI終端更換更大的螢幕嗎？

A：支援更換以下型別螢幕：

  1. SSD1306驅動的OLED螢幕：
    • 預設0.91寸4腳OLED單色螢幕(128*32解析度)
    • 可更換0.96寸、1.3寸和1.5寸(128*64解析度)等SSD1306驅動系列的4腳螢幕
    • 在 menuconfig 的 OLED Type 中選擇 SSD1306 12832、SSD1306 12864 或 SH1106 128*64，並重新編譯
  2. SPI-LCD螢幕：
    • bread-compact-wifi-lcd 等 LCD 麵包板方案支援 ST7789、ST7735、ST7796、ILI9341、GC9A01、NV3030B 等驅動，並區分解析度和 IPS 與否
    • 在 menuconfig 的 LCD Type 中選擇對應的螢幕驅動和解析度，編譯後燒錄

Q19：小智AI支援更換喚醒詞嗎？

A：支援，v2.5.2 有兩條路：

  1. 自訂喚醒詞：在 menuconfig 的 Wake Word Implementation Type 中選擇 Multinet model (Custom Wake Word)，用拼音（空格分隔）填寫喚醒詞，再填寫喚醒後發給服務端的顯示文字，並可調整閾值（1～99，越小越靈敏，預設 20）。需要 ESP32-S3 / P4 / S31 並帶 PSRAM，編譯環境見ESP-IDF 開發環境搭建及編譯小智
  2. Assets 生成器：上游提供網頁版的自訂 Assets 生成器，可以線上修改喚醒詞、字型、表情與聊天背景，見自訂 Assets 指南

預設的「你好小智」是 ESP-SR 的內建喚醒詞模型；ESP32-S3 之外的晶片可選的喚醒詞型別見晶片支援與儲存規格。

Q20：小智AI的角色名稱可以換嗎？

A：可以，到小智AI管理後臺控制面板——角色配置中修改AI角色名字，儲存後生效。

注意：角色名字是大模型配置的智慧體名稱，與離線喚醒詞"你好小智"無關，兩者不存在關聯。

Q21：小智AI支援更換聲音/音色嗎？

A：支援，到小智AI網站控制台——配置角色中切換角色聲音，可以先試聽，然後提交儲存配置。下次對話就會使用新配置的音色。

Q22：請問能讓小智AI聽聲辨人記住我是誰嗎？

A：可以，操作步驟：

  1. 到小智AI網站後臺控制台——智慧體——找到聲紋識別
  2. 在下拉選單中選擇一段語音記錄（建議較長且清晰的）
  3. 填寫名稱和描述（對話人和角色的關係）
  4. 點選OK按鈕新增說話人
  5. 重新喚醒小智AI，下次對話中詢問時，它會知道你是誰

注意：受技術限制，識別準確率不是100%；說話人越多，分辨準確率會下降。

Q23：小智AI支援更換成自己定製的聲音嗎？

A：內部測試中，此功能需要服務端支援，暫未開放上傳定製音色，請關注後續更新公告。

Q24：小智AI終端支援電池供電嗎，如何對接？

A：需要增加5V電壓升壓模組：

  1. ESP32S3開發板需要5V供電，鋰電池通常是3.8V電壓不夠，建議加裝5V充放電一體板
  2. 開發板外接5V供電：將5V充放電一體板的VOUT/5V+接開發板的5Vin引腳，GND接開發板GND引腳
  3. 也可使用充電寶/移動電源透過TYPE-C介面直接供電，建議使用5V2.1A輸出介面

Q25：小智AI終端支援語音控制馬達/舵機嗎？

A：預設不支援，需要加舵機/馬達驅動模組。ESP32-S3 可以透過裝置端 MCP 工具擴充（見 Q26），由大模型呼叫工具向驅動板輸出訊號。

目前小智AI已適配 ESP-SparkBot 開發板（目錄 espressif/esp-sparkbot，履帶底盤），透過 self.chassis.* 系列 MCP 工具實現前進、後退、轉向和跳舞。 開發板原始碼：espressif/esp-sparkbot

Q26：小智AI終端支援語音控制其他的裝置嗎？

A：支援，透過 MCP 實現：裝置端 MCP 可以控制音量、燈光、馬達、GPIO 等，雲端 MCP 可以擴充智慧家居控制、PC 桌面操作、知識搜尋、郵件收發等。協議與用法見 MCP 文件，裝置端要增加新工具需要自行開發。

Q27：請問小智AI支援市面上的哪些開發板？

A：v2.5.2 的釋出矩陣包含 154 個開發板目錄、188 個韌體變體，覆蓋 ESP32、ESP32-C3、ESP32-C5、ESP32-C6、ESP32-S3、ESP32-S31 和 ESP32-P4，完整列表見支援的開發板。

燒錄時請選擇對應變體的韌體，編譯時在 menuconfig 的 Target Board 中選擇對應開發板。其他開發板需要適配後重新編譯，見自訂開發板。

Q28：小智AI專案使用的是什麼大模型？服務端開源嗎？

A：裝置端韌體是開源的（78/xiaozhi-esp32），預設連線官方伺服器，個人使用者註冊賬號後可免費使用 Qwen 實時模型。 服務端方面，社群有多個開源實現，例如 xinnan-tech/xiaozhi-esp32-server（Python）、joey-zhou/xiaozhi-esp32-server-java（Java）、AnimeAIChat/xiaozhi-server-go（Golang）和 hackers365/xiaozhi-esp32-server-golang（Golang）。接入步驟和安全警示見自建服務端，完整名單見生態專案。

Q29：小智AI支援接入GPT等大模型嗎？

A：大模型由服務端對接，裝置韌體不直接連線大模型。使用官方伺服器時，可選的模型以官方控制台提供的為準；需要接入其他大模型時，可使用自建服務端。例如社群專案 xiaozhi-esp32-server 支援透過 OpenAI 相容介面接入阿里百鍊、火山引擎、DeepSeek、智譜、Gemini 等，詳見自建服務端。

更多資訊請參考上游專案 78/xiaozhi-esp32 的 README 與 docs 目錄，或在 GitHub Issues 反饋問題。

小智AI丐版 - ESP32開發板實現方案