Communitygithub.com

kk43994/kkclaw

Dale a tu AI Agent un cuerpo de escritorio — Asistente de configuración, 14 esferas emocionales, clonación de voz, ventana de letras, autodiagnóstico Doctor, soporte multiplataforma (Windows + macOS)

¿Qué es kkclaw?

kkclaw es una habilidad para AI Agent que le otorga una presencia visual y auditiva en tu escritorio. Se integra con plataformas como Claude Code, Cursor y Codex a través de OpenClaw Gateway, permitiendo que el agente se comunique mediante una esfera animada que expresa 14 emociones distintas y utiliza un sistema de voz con tres niveles de respaldo (MiniMax, CosyVoice, Edge TTS) para garantizar la reproducción en todo momento. Incluye un asistente de configuración (Setup Wizard) que guía al usuario en los primeros pasos, almacena claves API de forma segura con safeStorage, y ofrece funciones avanzadas como sincronización en tiempo real por WebSocket, autodiagnóstico Doctor para verificar el estado del sistema, y una ventana de letras tipo karaoke. Es ideal para desarrolladores que buscan una interfaz ligera, personalizable y confiable para sus agentes, con soporte completo en Windows y macOS.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add kk43994/kkclaw
Ver original→Ver todas las habilidades

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentación

kkclaw — Compañero de escritorio AI Langosta

Dale a tu AI Agent un cuerpo de escritorio: esfera visual + interacción por voz + expresión emocional.

Funcionalidades

  • 🧙 Setup Wizard — Guía de configuración inicial, listo en 3 minutos
  • 🔐 Cifrado safeStorage — Almacenamiento local cifrado de API Key, sin texto plano
  • 🎭 Personalización de personaje — Genera automáticamente AGENTS.md / SOUL.md / USER.md / HEARTBEAT.md
  • 🎵 Sistema de voz — Clonación de voz MiniMax + CosyVoice + Edge TTS con tres niveles de respaldo, nunca sin sonido
  • 👀 Expresión emocional — 14 emociones + múltiples microexpresiones oculares + efecto de brillo dinámico
  • 🩺 Autodiagnóstico Doctor — Diagnóstico con un clic de Gateway / modelo / TTS / puerto / registro / ventana de letras
  • 🎛️ Gestión de modelos — CRUD de proveedores, agregar/eliminar modelos, prueba de latencia, añadir predefinidos rápidamente
  • 🧠 Sincronización Gateway — Sincronización en tiempo real por WebSocket del estado de OpenClaw Agent, respuesta en milisegundos
  • 💪 Confiabilidad 7x24 — Recuperación automática, monitoreo de puntuación de salud, Switch Logger
  • 🖥️ Renderizado ligero — Esfera pura HTML/CSS/JS, textura vítrea con CSS radial-gradient, sin dependencias de frameworks
  • 🎤 Locución por voz — Respuestas del agente convertidas automáticamente a voz, con reconocimiento de emociones y marcas de pausa
  • 🖱️ Integración de escritorio — Ventana siempre al frente, transparencia al ratón, arrastre y seguimiento, ventana de subtítulos tipo letras

Stack tecnológico

  • Electron (contenedor de escritorio)
  • OpenClaw Gateway (comunicación WebSocket)
  • MiniMax Speech / CosyVoice / Edge TTS (síntesis de voz)
  • CSS Animation + requestAnimationFrame (animación de la esfera)

Instalación

git clone https://github.com/kk43994/kkclaw.git
cd kkclaw
npm install
npm start

O descarga el instalador:

Configuración

Edita pet-config.json para personalizar:

  • Motor TTS y voz
  • Color y tamaño de la esfera
  • Conexión a OpenClaw Gateway
  • Reglas de mapeo emocional
  • Flujo del Setup Wizard inicial

Estructura de directorios

kkclaw/
├── main.js              # Proceso principal de Electron
├── index.html           # UI de renderizado de la esfera
├── lyrics.html          # Ventana de subtítulos tipo letras
├── setup-wizard.html    # Interfaz del Setup Wizard
├── setup-wizard.js      # Lógica del Setup Wizard
├── gateway-client.js    # Cliente de comunicación Gateway
├── smart-voice.js       # Sistema de gestión de voz
├── templates/           # Archivos de plantilla del agente
├── voice/               # Módulos del motor TTS
├── utils/               # Módulos de utilidades
├── scripts/             # Scripts de compilación
└── docs-dev/            # Documentación de desarrollo

Enlaces

Skills relacionados

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community