Appearance
문제 해결
음성 인식이 작동하지 않아요
- API 키 확인: 설정 → API 키 탭에서 OpenAI API 키가 "활성화됨" 상태인지 확인하세요
- 마이크 권한: OS 설정에서 앱의 마이크 접근 권한을 허용했는지 확인하세요
- 마이크 선택: 설정 → 음성 인식 탭에서 올바른 마이크가 선택되어 있는지 확인하세요
OBS에 연결되지 않아요
- OBS Studio가 실행 중인지 확인하세요
- OBS → 도구 → WebSocket 서버 설정에서:
- "WebSocket 서버 활성화"가 체크되어 있는지 확인
- 포트 번호가 앱 설정과 같은지 확인 (기본: 4455)
- 비밀번호를 설정했다면 앱에도 같은 비밀번호를 입력
VTube Studio에 연결되지 않아요
- VTube Studio가 실행 중인지 확인하세요
- VTube Studio → 설정 → API에서 API가 활성화되어 있는지 확인하세요
- 처음 연결할 때 VTube Studio에 인증 팝업이 뜹니다 — 반드시 승인을 눌러주세요
AI가 아무 반응이 없어요
- 음성 인식이 켜져 있는지 확인하세요 (사이드바 버튼이 빨간색 "음성 인식 중지" 상태여야 합니다)
- 활동 피드에 "음성" 항목이 뜨는지 확인하세요 — 뜨지 않으면 마이크가 제대로 인식되지 않는 것입니다
- 연출 모드가 "소극적"이면 "게임 화면으로 전환해" 같은 명확한 명령만 처리합니다 — "적극적" 모드로 바꿔보세요
쿨다운 때문에 동작이 안 돼요
사이드바의 쿨다운 패널에서 현재 활성화된 쿨다운을 확인하세요.

- 개별 항목의 x 버튼으로 특정 쿨다운만 바로 해제할 수 있습니다
- ↺ 버튼으로 모든 쿨다운을 한꺼번에 해제할 수 있습니다
- 쿨다운이 너무 길다면 설정 → 리소스 관리에서 시간을 줄여보세요
설정을 바꿨는데 적용이 안 돼요
- 대부분의 설정은 바꾸는 즉시 적용됩니다
- 단축키: 바로 적용 (재시작 불필요)
- API 키, 연결 정보 변경: 앱을 재시작해야 할 수 있습니다