coderzc/open-xiaoai-bridge

해결하는 문제

Open-XiaoAI 브리지는 Xiaoai 스마트 스피커의 폐쇄된 생태계를 깨뜨려 외부 AI 서비스와 연결할 수 있게 합니다. 사용자는 내장된 AI를 더 유연하고 강력하며 맞춤형 LLM 기반 에이전트나 서비스로 교체할 수 있습니다.

작동 방식

이 프로젝트는 커스텀 Rust 클라이언트를 펌웨어 플래싱을 통해 설치한 수정된 Xiaoai 스피커와 다양한 AI 백엔드 사이의 서버 측 브리지 역할을 합니다. 스피커에서 오는 오디오를 캡처하고, VAD(음성 활동 탐지), KWS(키워드 탐지), 그리고 선택적 로컬 ASR(자동 음성 인식)을 사용해 처리한 후, 설정된 AI 서비스로 요청을 라우팅합니다. 브리지에서는 단일 턴 명령과 지속적인 다중 턴 대화를 모두 지원합니다.

대상 사용자

Xiaoai 스마트 스피커를 보유하고 있으며, OpenClaw 또는 QwenPaw와 같은 고급 AI 에이전트나 OpenAI 호환 API와 통합하여 개인화된 음성 제어 AI 어시스턴트를 만들고 싶은 사용자입니다.

주요 기능

• 다중 백엔드 지원: Ollama, LM Studio 등 OpenAI 호환 서비스, OpenClaw, QwenPaw, Xiaozhi AI와 통합 가능.
• 사용자 정의 웨이크워드: 여러 개의 사용자 정의 웨이크워드를 지원하며, 각각 다른 AI 서비스나 특정 에이전트로 라우팅 가능.
• 다중 에이전트 라우팅: 동일한 스피커에서 여러 개의 독립된 AI 성격을 호스팅할 수 있으며, 사용된 웨이크워드에 따라 에이전트 세션을 동적으로 전환 가능.
• 지속적 대화: 반복적으로 웨이크워드를 말할 필요 없이 다중 턴 대화를 가능하게 함.
• 원격 제어 API: HTTP API를 제공하여 원격으로 텍스트 음성 변환(TTS), 오디오 URL/파일 재생, 또는 장치를 깨우는 동작을 트리거할 수 있음.
• 하이브리드 ASR: 로컬 오프라인 ASR(SherpaASR)과 스피커의 내장 ASR 모두 지원.