Kkclaw

技术栈

• 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.0.0/KKClaw-Desktop-Pet-3.0.0-Setup.exe
• macOS (Intel): https://github.com/kk43994/kkclaw/releases/download/v3.0.0/KKClaw-Desktop-Pet-3.0.0-x64.dmg
• macOS (Apple Silicon): https://github.com/kk43994/kkclaw/releases/download/v3.0.0/KKClaw-Desktop-Pet-3.0.0-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 逻辑
├── openclaw-client.js   # Gateway WebSocket 客户端
├── 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.0.0