OpenClaw Alexa Voice Proxy: 양방향 음성 상호작용 구현 방법

openclaw-alexa-voice는 Alexa Custom Skill을 OpenClaw 게이트웨이에 연결하는 Node.js 프록시로, 이메일, 캘린더, 금융과 같은 도구에 대한 완전한 접근 권한을 가진 음성 상호작용을 가능하게 합니다. 이 시스템은 다양한 유형의 쿼리를 효율적으로 처리하기 위해 3단계 응답 아키텍처를 구현합니다.

3단계 응답 시스템

프록시는 복잡성과 처리 시간에 따라 응답을 세 가지 경로로 분류합니다:

빠른 경로 (<1초) – 시간, 날짜, 사용자 정의 API와 같은 간단한 쿼리 처리
에이전트 경로 (<12초) – AI 메모리에서 빠른 답변 제공
지연 경로 (<2분) – 복잡한 쿼리를 비동기적으로 처리한 후, Home Assistant TTS를 통해 모든 스피커에서 재생

작동 방식

쿼리가 도구 접근(이메일, 웹 검색, 시장 데이터)을 필요로 할 때, Alexa는 "확인해 볼게요"라고 응답하고 세션을 종료합니다. 그런 다음 프록시는 쿼리를 완전한 도구 접근 권한이 있는 OpenClaw의 메인 세션으로 전송하고, 최대 2분 동안 기다린 후, 마크다운 형식을 제거하고, Home Assistant의 Alexa Media Player 통합을 통해 모든 Echo 또는 Sonos 장치에서 응답을 재생합니다.

주요 기능

1시간 세션의 음성 PIN 인증
모든 Echo, Sonos 또는 스피커 그룹으로의 다중 스피커 TTS 라우팅
사용자 정의 API를 위한 확장 가능한 빠른 응답 시스템
TTS 실패 시 Telegram 폴백
Alexa 요청 서명 검증
속도 제한 및 감사 로깅
보안을 위해 localhost에만 바인딩

기술 스택

구현은 프록시용 Node.js, 음성 인터페이스용 Alexa Custom Skill, 통신용 OpenClaw 게이트웨이 WebSocket, TTS 재생용 Home Assistant를 사용합니다. 이 접근 방식은 개발자가 OpenClaw 인스턴스에 음성 기능을 확장하면서도 로컬 바인딩과 인증을 통해 보안을 유지할 수 있게 합니다.

이 프로젝트는 Discussion #11154에서 영감을 받았으며, OpenClaw 설정에 음성 상호작용을 추가하려는 개발자를 위해 오픈 소스로 제공됩니다. 3단계 시스템은 반응성이 뛰어난 음성 상호작용을 보장하면서도 복잡한 쿼리가 OpenClaw의 완전한 도구 기능을 활용할 수 있게 합니다.

📖 전체 소스 읽기: r/openclaw