kkclaw — Companheiro de IA de Mesa - Lagosta
Dê ao seu agente de IA um corpo de mesa: esfera visualizada + interação por voz + expressão emocional.
Funcionalidades
- 🧙 Setup Wizard — Guia de configuração na primeira execução, pronto em 3 minutos
- 🔐 Criptografia safeStorage — Chave de API armazenada localmente de forma criptografada, sem texto simples
- 🎭 Personalização de Persona — Gera automaticamente
AGENTS.md/SOUL.md/USER.md/HEARTBEAT.md - 🎵 Sistema de Áudio — Clonagem de voz MiniMax + CosyVoice + Edge TTS com fallback de três níveis, nunca sem som
- 👀 Expressão Emocional — 14 emoções + múltiplas microexpressões oculares + efeito glow dinâmico
- 🩺 Auto-diagnóstico Doctor — Diagnóstico com um clique de Gateway / Modelo / TTS / Porta / Log / Janela de legendas
- 🎛️ Gerenciamento de Modelos — CRUD de provedores, adição/remoção de modelos, teste de latência, adição rápida de predefinições
- 🧠 Sincronização Gateway — Sincronização em tempo real via WebSocket do estado do agente OpenClaw, resposta em milissegundos
- 💪 Confiável 7x24 — Recuperação automática, monitoramento de pontuação de saúde, Switch Logger
- 🖥️ Renderização Leve — Esfera em HTML/CSS/JS puro, textura vítrea com gradiente radial CSS, sem dependências de frameworks
- 🎤 Narração por Voz — Respostas do agente convertidas automaticamente em fala, com reconhecimento de emoções e marcação de pausas
- 🖱️ Integração com a Área de Trabalho — Janela sempre no topo, transparência de mouse, arrastar para seguir, janela de legendas estilo karaokê
Stack Tecnológica
- Electron (contêiner de desktop)
- OpenClaw Gateway (comunicação WebSocket)
- MiniMax Speech / CosyVoice / Edge TTS (síntese de fala)
- CSS Animation + requestAnimationFrame (animação da esfera)
Instalação
git clone https://github.com/kk43994/kkclaw.git
cd kkclaw
npm install
npm start
Ou baixe o instalador:
- 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
Configuração
Edite pet-config.json para personalizar:
- Motor TTS e voz
- Cor e tamanho da esfera
- Conexão com o Gateway OpenClaw
- Regras de mapeamento de emoções
- Fluxo guiado do Setup Wizard na primeira execução
Estrutura de Diretórios
kkclaw/
├── main.js # Processo principal do Electron
├── index.html # UI de renderização da esfera
├── lyrics.html # Janela de legendas
├── setup-wizard.html # Interface do Setup Wizard
├── setup-wizard.js # Lógica do Setup Wizard
├── gateway-client.js # Cliente de comunicação Gateway
├── smart-voice.js # Sistema de agendamento de voz
├── templates/ # Arquivos de modelo do agente
├── voice/ # Módulos do motor TTS
├── utils/ # Módulos utilitários
├── scripts/ # Scripts de build
└── docs-dev/ # Documentação de desenvolvimento
Links
- GitHub: https://github.com/kk43994/kkclaw
- Landing Page: https://kk43994.github.io/kkclaw/
- ClawHub: https://clawhub.ai/kk43994/desktop-pet
- Versão: v3.1.2