介紹一個小愛同學接入AI項目，支持多個大模型

大家好，我是羊刀仙。

不知道各位家裏有沒有智能音箱？沒錯，就是小愛和天貓精靈這種語音助手。剛推出的時候的確比較新奇好玩，但現在感覺妥妥的一個大傻X。現在AI十分流行，那麼是否有辦法把語音助手也接入AI呢？

本次就來介紹一個相關的開源項目：MiGPT，將小愛音箱接入 ChatGPT 和豆包（字節），改造成你的專屬語音助手。

本文會通過使用 Docker 方式來和大家一起手把手搭建這個項目，小白也能輕鬆搞定！

項目地址：點我跳轉

項目簡介

在這個數字化的世界裏，家已不僅僅是一個居住的地方，而是我們數字生活的延伸。

MiGPT 通過將小愛音箱、米家智能設備，與 ChatGPT 的理解能力完美融合，讓你的智能家居更懂你。

MiGPT 不僅僅是關於設備自動化，而是關於：打造一個懂你、有溫度、與你共同進化的家。

未來，你的每個智能家居設備，從燈泡、插座，到掃地機器人、電視等，

都可以作爲一個個獨立的智能體 (Agent)，更智能、更貼心的響應你的指令。

這些獨立的智能體，也可以彼此感知，彼此配合，構成一個更強大的協作網絡。

而小愛音箱就像是你的智能家居專屬管家，全心全意爲你服務，釋放智能家居的真正潛力。

項目亮點

🎓 AI 問答。想象一下，當小愛音箱接入大模型後，上知天文，下知地理，從“人工智障”秒變學霸。

🎭 角色扮演。一秒調教小愛，無論是成爲你的完美伴侶，還是那個能聽你傾訴心事的貼心閨蜜，都不在話下。

💬 流式響應。愛情來得太快就像龍捲風，而你的小愛音箱也是，對你的愛意秒回，愛你不會讓你等太久。

🧠 長短期記憶。小愛音箱現在能記住你們之間的每一次對話，越聊越默契，就像是你身邊的老朋友。

🔊 自定義 TTS。厭倦了小愛同學的語音？幫你解鎖「豆包」同款音色，就像真人在回你的消息。

🤖️ 智能家居 Agent。心情不好？小愛立刻懂你，自動幫你播放喜歡的音樂，調節燈光，逗你開心。

設備支持

MiGPT 支持大部分的小愛音箱型號，推薦使用小愛音箱 Pro（完美運行）。

小愛音箱 HD 以及小愛藍牙音箱隨身版完全不支持該項目。

部署流程

以威聯通NAS爲例，型號爲TS-673A。

文件目錄與配置文件

首先爲MiGPT準備文件目錄。直接命名爲MiGPT，此外還需要準備 .env 和 .migpt.js 兩個配置文件放於該目錄下。

爲了方便起見，直接在項目地址下載下圖的兩個文件，編輯後重新命名再上傳至NAS即可。

在NAS中打開Text Editor文本編輯器，創建文本文件。將以下代碼分別粘貼進去，進行修改並另存爲至MiGPT目錄下。

⭕️ 環境變量.env配置：

一般來說僅需修改以下幾個部分

OPENAI_MODEL=llama3-70b-8192，這裏的phi3:latest可以換成其他模型

OPENAI_API_KEY=gsk_xxxxx，這個沒關係隨便寫一個

OPENAI_BASE_URL=https://api.groq.com/openai/v1，這個地址其實就是運行大模型的地址

更多AI接入請參考https://migptgui.com/docs/apply/ ，我個人使用的是作者推薦的Groq提供的llama3-70b-8192，應該是目前唯一一家免費提供 70B 參數規模的 Llama3 模型的廠商。
另存爲.env ，是一個隱藏文件，看不到正常。在 Linux 和類 Unix 系統（包括大多數 NAS 設備的操作系統）中，以 “.” 開頭的文件默認是隱藏的。這是操作系統的一種標準做法，目的是防止這些配置文件被用戶不小心修改或刪除。

⭕️ 音箱.migpt.js配置

重複上面操作，先新建文檔。配置模板如下。內容較多，大家可以先往下劃，我列出了必須修改部分，其他內容等自己回頭再慢慢改～

必須需要修改的是userId、password、did就是你的小愛音箱型號：

// 小米 ID userId: "978765301", // 注意：不是手機號或郵箱，請在「個人信息」-「小米 ID」查看

// 賬號密碼，就是你小米賬戶登陸的那個密碼

password: "Keepfit75KG!",

// 小愛音箱 DID 或在米家中設置的名稱 did: "小愛音箱Pro", // 注意空格、大小寫和錯別字（音響 👉 音箱），不要出任何錯誤

參考上面的設備支持部分，這個變量請根據自己型號修改false或true，默認爲true：

// 是否啓用連續對話功能，部分小愛音箱型號無法查詢到正確的播放狀態，需要關閉連續對話 streamResponse: true, // 連續對話時，無響應多久後自動退出

以上工作完成後，另存爲即可。

Docker Compose部署

打開Cintainer Station，創建新的應用，將以下代碼修改並創建即可。

系統會自動幫我們拉取鏡像並運行項目。

部署完畢後，查看Docker日誌，出現以下界面便說明可以使用了。

嘗試對話，跟作者配置中的一樣，確實有些傲嬌。。。

常見問題

皆摘自原項目。很多問題解決方案，以及自定義配置教程在原項目都十分詳細，這裏只是挑些可能較爲常見的說明，爲大家節省點時間。

是否支持其他模型，是否支持其他TTS接入

理論上兼容 OpenAI SDK的模型都支持，修改環境變量即可接入到 MiGPT。比如：通義千問、零一萬物、Moonshot、DeepSeek等。

具體的配置可查看該鏈接：https://migptgui.com/docs/apply/tongyi

對於其他不兼容的大模型，比如豆包、文心一言等，也可以通過第三方的 API 聚合工具將其轉換爲 OpenAI API 兼容的格式。比如： One API和 simple-one-api（推薦：支持 coze，使用更簡單），然後修改對應的環境變量值即可完成接入。

支持任意的TTS服務接入，建議參考：https://github.com/idootop/mi-gpt/blob/main/docs/tts.md

AI回答調速、開啓喚醒模式

這兩項都可在小愛的配置文件中修改調整.

回答調速：

// .migpt.js export default { speaker: { // 使用小愛自帶的 TTS 引擎 tts: "xiaoai", // 關閉 AI 開始回答時的提示語 onAIAsking: [], // 關閉 AI 結束回答時的提示語 onAIReplied: [], // 連續對話時，播放狀態檢測間隔（單位毫秒，最低 500 毫秒，默認 1 秒） checkInterval: 500, // 調小此值可以降低小愛回覆之間的停頓感，請酌情調節 // 連續對話時，下發 TTS 指令多長時間後開始檢測設備播放狀態（單位秒，最好不要低於 1s，默認 3 秒） checkTTSStatusAfter: 3, // 可適當調小或調大 // ... }, };

喚醒和連續對話模式，召喚傻妞後，便無需每句對話以小愛同學作爲起始：

// .migpt.js export default { speaker: { // 當消息以下面的關鍵詞開頭時，會調用 AI 來回復消息 callAIKeywords: ["請", "你", "傻妞"], // 當消息以下面的關鍵詞開頭時，會進入 AI 喚醒狀態 wakeUpKeywords: ["打開", "進入", "召喚"], // ... }, };

喚醒小愛同學

正常對小愛音箱說“小愛同學”，喚醒其進入聽寫狀態。

喚醒小愛同學後，可以對她說語音指令，比如“請問地球爲什麼是圓的”

此時，只有以callAIKeywords開頭的消息，纔會調用 AI 進行回覆。

此階段無法做到連續對話，每次提問都要以“小愛同學，請 xxx”開頭。

進入喚醒模式

默認不會調用 AI 進行回覆

喚醒模式（AI 模式）類似小愛技能，進入後可以連續對話

使用wakeUpKeywords即可進入喚醒模式，比如“小愛同學，召喚傻妞”

進入喚醒模式後，每次提問請等待小愛回答“我說完了”之後，再繼續向她提問

此時，可直接向小愛提問題，無需再以“小愛同學，xxx”開頭。

無法使用、啓動失敗等

該類問題極大概率是AI和小米各自那三個變量的配置問題，重點關注網絡問題、API是否需要付費等。

⭕️ LLM 響應異常 Connection error，也就是AI不能回覆，國內環境無法訪問 AI 服務的情況，需要魔法，本文只建議更換使用國內LLM （Moonshot、零一萬物、通義千問等）。

⭕️ LLM 響應異常 404 The model xxx does not exist，意爲該模型不存在或不可用，基本就是沒權限要付費那種，建議切換到其他模型。

⭕️ LLM 響應異常，401 Invalid Authentication， 404 基本都是OpenAI_API_KEY 無效。檢查OpenAI_API_KEY是否能正常使用，以及對應環境變量是否生效。

⭕️ LLM 響應異常，404 Not Found，可能代理 IP 被 Cloudflare 風控，可嘗試切換節點。或者把環境變量的 HTTP_PROXY 設置成空字符串 HTTP_PROXY='' 關閉代理（僅適用於國產大模型）。

無AI回答，但是後臺日誌有文字信息輸出

這與小愛音箱的型號有關，請到米家產品庫查看參數並修改：

ttsCommand: [5, 1], // 設備喚醒指令，請到 https://home.miot-spec.com 查詢具體指令 wakeUpCommand: [5, 3], // 查詢是否在播放中指令，請到 https://home.miot-spec.com 查詢具體指令 // playingCommand: [3, 1, 1], // 默認無需配置此參數，查詢播放狀態異常時再嘗試開啓