以下作品由安信可社區用戶

無垠的廣袤制作

感謝安信可社區的支持，免費領到了安信可的最新產品小安AI - AiPi-PalChatV1 語音開發板。

原貼地址：

【AiPi-PalChatV1語音開發板】開箱、配網、對話

【AiPi-PalChatV1語音開發板】小智 MCP 接入 Home Assistant

目錄

一、開箱

1.1包裝

1.2開發板

二、開發板介紹

2.1功能特點

2.2技術參數

2.3適應場景

2.4原理圖

三、上電及配網

四、效果

五、MCP 介紹

六、準備工作

七、小智 MCP 接入 HA

八、補充介紹：小智 MCP 啟動器和小智 AI 客戶端

01開箱

介紹了 AiPi-PalChatV1 語音開發板的包裝及外觀等。

包裝

外層防靜電袋，保護精密器件在運輸途中遠離摩擦靜電影響；

PP 環保塑料外殼包裝，加上內層隔振海綿，確保運輸過程中開發板的穩固安全。

開發板

該套件包括開發板、麥克風、揚聲器，已連接至相應的快接插頭。

02開發板介紹

AiPi-PalChatV1 是一款接入了小智AI智能體的微型語音交互開發板，專為輕量級智能語音場景設計。

基于安信可 Ai-WB2-12F 模組主控，具備高集成度、高性價比等特性，支持離線語音喚醒與語音打斷功能，結合2W/8Ω 揚聲器與雙供電模式（Type-C + 電池），適用于快速部署語音交互能力的硬件創新場景。

功能特點

離線語音交互

支持離線語音喚醒，解放雙手。

支持語音打斷，提升交互自然度。

靈活供電模式

Type-C 有線供電，適配常規電源環境。

電池供電設計，滿足移動場景需求。

輕量級硬件配置

小尺寸板載設計，易于集成到各類設備中。

2W/8Ω 揚聲器提供清晰音效輸出。

便捷開發與配置

微信小程序一鍵配網，簡化設備聯網流程。

智能體配置可視化，支持自定義音色與場景邏輯。

全新模組連接方案

安信可 Ai-WB2 系列模組，多種尺寸。

低成本快速落地

開箱即用的語音方案，降低開發周期與硬件成本。

高兼容性

支持主流物聯網協議，可擴展接入智能家居生態。

技術參數

模塊	參數詳情
主控	安信可 Ai-WB2-12F 模組（Wi-Fi/BLE 雙模）
喚醒方式	離線語音喚醒，語音打斷
揚聲器	2W/8Ω 喇叭
MIC	駐極體麥克風，靈敏度：-29dB
供電	Type-C（5V） 或 3.7V 鋰電池
喚醒詞	默認：你好小安
開發支持	SDK 二次開發接口

智能家居控制

作為語音中控模塊，嵌入燈具、窗簾、家電等設備，實現本地化語音控制。

低成本改造傳統家居為智能語音交互場景。

教育/兒童玩具

集成到早教機、故事機中，支持離線語音問答與互動內容播放。

工業設備交互

為小型工業設備（如檢測儀、控制面板）添加語音指令操作，提升人機交互效率。

原理圖

電源管理

供電

Sound

麥克風

主控

外設

源碼及固件詳見：

https://gitee.com/Ai-Thinker-Open/xiaoan-ai_wb2

固件上傳方案詳見：

AI語音開發板AiPi-PalChatV1教程：燒錄與調試

03上電及配網

上電

檢查麥克風、揚聲器、屏幕是否已連接；

使用 Type-C 數據線接入設備的 Type-C 口，打開電源開關，紅燈亮起。

播報語音：【 我是你的人工智能語音助手，請對我說，你好小安，開始配網 】

若接入電池，在 Type-C 數據線接入后，藍色充電指示燈亮起表示正在充電，熄滅表示充滿，閃爍表示未插入電池。

配網

首次啟動需配置網絡連接

對麥克風說：【你好小安】

回復：我在

說：【開始配網】

回復：進入配網模式，請使用安信可小程序或App 進行配網

小程序

打開 安信可 IOT 微信小程序；

選擇 AI 硬件智能體 ，點擊 添加設備 - 掃描設備 ；

點擊連接 BL602_XZ_V1.0_XXXXXXXXXX 設備；

填寫 WiFi 名稱和密碼 - 配置 WiFi

回復：連網中

回復：連網成功

若連接失敗，則需重啟設備，重新配網

小智 AI 界面

完成設備配網后，開發板會循環播報驗證碼，如 028030 ，此時需進行小智 AI 配對；注冊和登錄 小智 AI

網頁端，點擊 控制臺 - 新建智能體 - 輸入相應的個性化配置；

點擊添加設備 - 輸入播報的 6 位數字 - 手動復位設備；

上電之后，播報 聯網成功，再喚醒設備。

語音喚醒：你好小安

回復：我在

之后便可進行連續對話。

04效果

聯網后可通過對話調整音量

查看視頻?www.bilibili.com/video/BV1Vrjfz7EmK/?spm_id_from=888.80997.embed_other.whitelist&t=1.950844&bvid=BV1Vrjfz7EmK&vd_source=54c5db21948db2378659b7e8e42bafbf

彩蛋：可以播放歌曲，音質還不錯哦~

查看視頻?www.bilibili.com/video/BV1Vrjfz7EXy/?spm_id_from=888.80997.embed_other.whitelist&t=1.335934&bvid=BV1Vrjfz7EXy&vd_source=54c5db21948db2378659b7e8e42bafbf

05MCP 介紹

消息上下文協議 (Model Context Protocol, MCP) 是一個開放協議，用于標準化應用程序如何向 LLM 提供上下文。

MCP 為 AI 模型連接不同的數據源和工具提供了標準化的方式。

MCP 可用于構建 AI 驅動的 IDE、增強聊天界面、創建自定義 AI 工作流等場景。它能幫助開發者更好地管理和利用 LLM 的上下文信息。

詳見：

MCP中文簡介 – MCP 中文站（Model Context Protocol 中文）

Model Context Protocol

MCP - python-sdk

06準備工作

包括 Home Assistant 安裝以及 HACS 部署、小智 MCP 接入等流程。

Home Assistant 安裝

1.安裝 Docker 容器

2.本地下載并部署 EMQX 平臺

3.部署 HomeAssistant 智能家居平臺

詳見：

【BW21-CBV-Kit 開發套件測評】OLED藍牙溫濕度計與Home Assistant連接藍牙溫濕度計 DIY

HACS 部署

在 Docker 安裝 HomeAssistant 的基礎上，部署 HACS 應用商店。

shell_command服務

復制代碼到 HA 配置文件 configuration.yaml

shell_command:  update_hacs_china:|-    wget -O - https://get.hacs.vip | bash -

重啟 HA 使配置生效，在開發者工具中執行動作

action: shell_command.update_hacs_china

再次重啟HA使更新后的 HACS 生效

或下載 HACS 至本地，將其復制到 HA 安裝目錄 config/custom_components/hacs 路徑，重啟 HA ，添加集成即可。

參考：

hacs-china

hacs-china 極速版

07小智 MCP 接入 HA

原理

使用小智官方給的示例代碼，結合 mcp_proxy，實現小智官方服務器和 Home Assistant 的 MCP Server 打通。

參數

XIAOZHI_MCP_ENDPOINT

小智 MCP 接入點，登錄 小智 官方服務器獲取；

HA_MCP_ENDPOINT

HA MCP SERVER 地址 ，通過 HA 官方的 mcp_server 集成獲取，通過鏈接 Home Assistant MCP Server 集成 直達安裝，列表中選擇 Model Context Protocol 并完成配置；

API_ACCESS_TOKEN

長效 API 令牌，訪問 Home Assistant 賬戶配置文件設置，進入 安全 標簽，創建長期訪問令牌。

詳見：

shawn996/mcp_ha_xiaozhi: 小智官方服務器(蝦哥)對接home assistant的mcp server

安裝

在 Home Assistant 已安裝 HACS 的基礎上

打開HACS, 點擊 Custom repositories

Repository 輸入項目地址: https://github.com/c1pher-cn/ha-mcp-for-xiaozhi ；

Category 選擇 Integration 。

點擊 ADD 添加外部鏈接，選擇 MCP Server for Xiaozhi 并 Download 下載安裝該插件；

設置 - 右上角 更多 選項 - 重啟 Home Assistant ；

進入HACS，可見 MCP Server for Xiaozhi 已下載和安裝；

配置

設置 - 設備與服務 - 添加集成 - 搜索 MCP 安裝 MCP Server for Xiaozhi ；

填寫小智接入點地址 - 提交 - 添加成功。

訪問小智 AI 控制臺，查看 MCP 接入點狀態，顯示 在線 表明 小智與 HA 連接配置成功。

在 設置 - 語音助手 選項下開啟 HA 語音助手；

之后可通過 AiPi-PalChatV1 開發板控制 HomeAssistant 平臺的設備、訪問獲取傳感器參數等。

詳見：

Homeassistant MCP server for 小智AI

08補充介紹：小智 MCP 啟動器和小智 AI 客戶端

介紹下小智 MCP 啟動器和小智 AI 客戶端，便于設備調試與小智連接 HA 項目的測試。

小智 AI MCP 啟動器

參考：

小智AI配置MCP接入點使用說明

可視化xiaozhi接入mcp

小智 AI 客戶端

Python版本的小智ai，可以在沒有硬件支持的條件下實現小智 AI 對話功能。

介紹

py-xiaozhi 是一個使用 Python 實現的小智語音客戶端，旨在通過代碼學習和在沒有硬件條件下體驗 AI 小智的語音功能。

IoT 功能

py-xiaozhi 提供豐富的 IoT 設備控制功能：

虛擬設備：燈光控制、音量調節、倒計時器等；

物理設備集成：溫度傳感器、攝像頭等；

Home Assistant集成：通過HTTP API接入智能家居系統；

自定義設備擴展：提供完整的設備定義和注冊框架。

詳見：

python版本的小智ai

小智Android端

審核編輯 黃宇