kkclaw — Desktop-Lobster-KI-Begleiter
Gib deinem KI-Agenten einen Desktop-Körper: Visualisierte Kugel + Sprachinteraktion + Emotionsausdruck.
Funktionen
- 🧙 Setup-Wizard — Erste Inbetriebnahme mit Einrichtungsanleitung, in 3 Minuten einsatzbereit
- 🔐 safeStorage-Verschlüsselung — API-Schlüssel werden lokal verschlüsselt gespeichert, keine Klartexte mehr
- 🎭 Charakterkonfiguration — Automatische Generierung von
AGENTS.md/SOUL.md/USER.md/HEARTBEAT.md - 🎵 Sprachsystem — MiniMax-Sprachklon + CosyVoice + Edge TTS in dreistufiger Degradierung, niemals stumm
- 👀 Emotionsausdruck — 14 Emotionen + verschiedene Augenmikroexpressionen + dynamischer Glow-Effekt
- 🩺 Doctor-Selbsttest — Ein-Klick-Diagnose von Gateway / Modell / TTS / Port / Log / Liedtextfenster
- 🎛️ Modellverwaltung — Provider CRUD, Modelle hinzufügen/löschen, Latenzmessung, Schnellvoreinstellungen
- 🧠 Gateway-Synchronisation — WebSocket-Echtzeitsynchronisation des OpenClaw-Agentenstatus, Millisekunden-Reaktionszeit
- 💪 7x24 zuverlässig — Automatische Wiederherstellung, Gesundheitsbewertungsüberwachung, Switch-Logger
- 🖥️ Leichtgewichtiges Rendering — Reines HTML/CSS/JS-Kugeldesign, CSS radial-gradient mit Glaseffekt, keine Frameworks erforderlich
- 🎤 Sprachausgabe — Agentenantwort wird automatisch in Sprache umgewandelt, unterstützt Emotionserkennung und Pausenmarkierungen
- 🖱️ Desktop-Integration — Fenster immer im Vordergrund, Mausdurchlässigkeit, Ziehen-folgen, Liedtext-Untertitel-Fenster
Technologie-Stack
- Electron (Desktop-Container)
- OpenClaw Gateway (WebSocket-Kommunikation)
- MiniMax Speech / CosyVoice / Edge TTS (Sprachsynthese)
- CSS-Animation + requestAnimationFrame (Kugelanimation)
Installation
git clone https://github.com/kk43994/kkclaw.git
cd kkclaw
npm install
npm start
Oder Installationspaket herunterladen:
- 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
Konfiguration
Bearbeite pet-config.json zur Anpassung von:
- TTS-Engine und Stimme
- Kugelfarbe und -größe
- OpenClaw Gateway-Verbindung
- Emotionszuordnungsregeln
- Setup-Wizard-Ersteinrichtungsablauf
Verzeichnisstruktur
kkclaw/
├── main.js # Electron-Hauptprozess
├── index.html # Kugel-Rendering-UI
├── lyrics.html # Liedtext-Untertitel-Fenster
├── setup-wizard.html # Setup-Wizard-Oberfläche
├── setup-wizard.js # Setup-Wizard-Logik
├── gateway-client.js # Gateway-Kommunikationsclient
├── smart-voice.js # Sprachverwaltungssystem
├── templates/ # Agent-Vorlagendateien
├── voice/ # TTS-Engine-Module
├── utils/ # Hilfsmodule
├── scripts/ # Build-Skripte
└── docs-dev/ # Entwicklerdokumentation
Links
- GitHub: https://github.com/kk43994/kkclaw
- Landing Page: https://kk43994.github.io/kkclaw/
- ClawHub: https://clawhub.ai/kk43994/desktop-pet
- Version: v3.1.2