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

AiPi-PalChatV1 基于安信可 Ai-WB2-12F 模組主控，具備高集成度、高性價比等特性，支持離線語音喚醒與語音打斷功能。

此款開發板結合 2W/8Ω 揚聲器與雙供電模式（Type-C + 電池），適用于快速部署語音交互能力的硬件創新場景，如早教機、故事機，支持語音問答與互動內容播放。

核心功能亮點

離線語音交互

支持遠距離離線語音喚醒，無需按鍵，解放雙手。

支持語音打斷，提升交互自然度。（專治AI話癆，讓AI更懂你）

靈活供電模式

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

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

輕量級硬件配置

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

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

微信小程序開發與配置

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

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

01MP3 文件獲取

首先制作提示音

推薦網站：https://www.text-to-speech.cn/

格式要求：
16KHz 單聲道音頻
深度 32bit
在 SDK 的 voice 文件夾下創建提示音的文件夾，例如：voice/廣西表哥
提示音列表，按照以下列表生成所有的提示音，并放在提示音文件夾下
提示音的名稱不能改變，否則會影響后續步驟的進行！

02音頻轉換

運行腳本，進入到文件夾

cd voice

安裝腳本依賴

pip3 install pydub opuslib numpy

運行音頻生成腳本，例如：廣西表哥

python3 mp3_to_opus.py 廣西表哥/

替換文件，將生成的 xiaozhi_voic.h 替換 xiaozhi 文件夾下的 xiaozhi_voic.h

mv -f 廣西表哥/xiaozhi_voic.h ../xiaozhi/xiaozhi_voic.h

03編譯測試

回到 SDK

cd ..

編譯

make -j

燒錄

make -j p=/dev/ttyUSBx

/dev/ttyUSBx 是電腦實際的串口號，可用下方指令查詢：

ls /dev/tty*

04問題及解決方法

安裝opuslib和numpy庫時出錯

只是因為環境問題導致的安裝出錯，可按照以下步驟解決。

安裝 python 虛擬環境工具

sudo apt install python3-venv

創建虛擬環境（例如在項目目錄）

python3 -m venv myenv

激活虛擬環境

source myenv/bin/activate

重新安裝依賴庫

pip3 install pydub opuslib numpy

審核編輯 黃宇