kkclaw — 데스크톱 랍스터 AI 컴패니언
AI 에이전트에게 데스크톱 신체를 부여하세요: 시각적 구체 + 음성 인터랙션 + 감정 표현.
기능 특징
- 🧙 Setup Wizard — 최초 실행 시 설정 가이드 제공, 3분 만에 시작
- 🔐 safeStorage 암호화 — API Key를 로컬에 암호화하여 저장, 더 이상 평문 노출 없음
- 🎭 페르소나 커스터마이징 —
AGENTS.md/SOUL.md/USER.md/HEARTBEAT.md자동 생성 - 🎵 음성 시스템 — MiniMax 음성 복제 + CosyVoice + Edge TTS 3단계 폴백, 끊김 없는 음성 출력
- 👀 감정 표현 — 14가지 감정 + 다양한 눈 미세 표정 + 동적 글로우 효과
- 🩺 Doctor 자가 진단 — Gateway / 모델 / TTS / 포트 / 로그 / 가사 창 한 번에 진단
- 🎛️ 모델 관리 — Provider CRUD, 모델 추가/삭제, 지연 시간 측정, 사전 설정 빠른 추가
- 🧠 Gateway 동기화 — WebSocket을 통한 OpenClaw Agent 상태 실시간 동기화, 밀리초 단위 응답
- 💪 7x24 신뢰성 — 자동 복구, 건강 점수 모니터링, Switch Logger
- 🖥️ 경량 렌더링 — 순수 HTML/CSS/JS 구체, CSS radial-gradient 유리 질감, 프레임워크 불필요
- 🎤 음성 방송 — Agent 응답을 자동으로 음성 변환, 감정 인식 및 일시 정지 태그 지원
- 🖱️ 데스크톱 통합 — 창 항상 위에 표시, 마우스 통과, 드래그 따라가기, 가사 자막 창
기술 스택
- Electron (데스크톱 컨테이너)
- OpenClaw Gateway (WebSocket 통신)
- MiniMax Speech / CosyVoice / Edge TTS (음성 합성)
- CSS Animation + requestAnimationFrame (구체 애니메이션)
설치
git clone https://github.com/kk43994/kkclaw.git
cd kkclaw
npm install
npm start
또는 설치 패키지 다운로드:
- Windows: https://github.com/kk43994/kkclaw/releases/download/v3.1.2/KKClaw-Desktop-Pet-3.1.2-Setup.exe
- macOS (Intel): https://github.com/kk43994/kkclaw/releases/download/v3.1.2/KKClaw-Desktop-Pet-3.1.2-x64.dmg
- macOS (Apple Silicon): https://github.com/kk43994/kkclaw/releases/download/v3.1.2/KKClaw-Desktop-Pet-3.1.2-arm64.dmg
설정
pet-config.json을 편집하여 다음을 사용자 정의:
- TTS 엔진 및 음성
- 구체 색상 및 크기
- OpenClaw Gateway 연결
- 감정 매핑 규칙
- Setup Wizard 최초 실행 가이드 흐름
디렉토리 구조
kkclaw/
├── main.js # Electron 메인 프로세스
├── index.html # 구체 렌더링 UI
├── lyrics.html # 가사 자막 창
├── setup-wizard.html # Setup Wizard 인터페이스
├── setup-wizard.js # Setup Wizard 로직
├── gateway-client.js # Gateway 통신 클라이언트
├── smart-voice.js # 음성 스케줄링 시스템
├── templates/ # Agent 템플릿 파일
├── voice/ # TTS 엔진 모듈
├── utils/ # 유틸리티 모듈
├── scripts/ # 빌드 스크립트
└── docs-dev/ # 개발 문서
링크
- GitHub: https://github.com/kk43994/kkclaw
- Landing Page: https://kk43994.github.io/kkclaw/
- ClawHub: https://clawhub.ai/kk43994/desktop-pet
- 버전: v3.1.2