Communitygithub.com

kk43994/kkclaw

Donnez un corps de bureau à votre agent IA — Assistant de configuration, 14 émotions de sphère, clonage vocal, fenêtre de paroles, auto-diagnostic Doctor, prise en charge multiplateforme (Windows + macOS)

Qu'est-ce que kkclaw ?

kkclaw est un compagnon de bureau pour agent IA sous forme de sphère visuelle, offrant une interaction vocale et une expression émotionnelle riches. Il permet à votre agent IA d'avoir un corps physique sur le bureau, avec une sphère animée qui affiche 14 émotions différentes et des micro-expressions oculaires. Le système audio utilise MiniMax, CosyVoice et Edge TTS avec une dégradation progressive pour garantir une synthèse vocale fiable. Il prend en charge le stockage chiffré des clés API via safeStorage, la personnalisation de la personnalité de l'agent, la synchronisation en temps réel via WebSocket avec OpenClaw Gateway, et un auto-diagnostic complet (Doctor) pour vérifier la connectivité, les modèles, le TTS, les ports, les logs et la fenêtre de paroles. L'installation est simple via npm ou un installateur pré-construit pour Windows et macOS. La sphère est rendue avec du HTML/CSS/JS pur, ne nécessitant pas de framework lourd, et offre des fonctionnalités de bureau telles que le maintien au premier plan, la transparence souris, le suivi par glissement et une fenêtre de sous-titres façon karaoké.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add kk43994/kkclaw
Voir l'original→Voir toutes les compétences

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentation

kkclaw — Compagnon IA de Bureau (Homard)

Donnez un corps de bureau à votre agent IA : sphère visuelle + interaction vocale + expression émotionnelle.

Fonctionnalités

  • 🧙 Assistant de Configuration — Guide de configuration au premier lancement, prêt en 3 minutes
  • 🔐 Chiffrement safeStorage — Stockage chiffré local des clés API, plus de texte en clair
  • 🎭 Personnalisation du Personnage — Génération automatique de AGENTS.md / SOUL.md / USER.md / HEARTBEAT.md
  • 🎵 Système Audio — Clonage vocal MiniMax + CosyVoice + Edge TTS en dégradation progressive, jamais de silence
  • 👀 Expression Émotionnelle — 14 émotions + multiples micro-expressions oculaires + effet lumineux dynamique
  • 🩺 Auto-Diagnostic Doctor — Diagnostic en un clic de la passerelle / modèle / TTS / port / logs / fenêtre de paroles
  • 🎛️ Gestion des Modèles — CRUD des fournisseurs, ajout/suppression de modèles, test de latence, ajout rapide de préréglages
  • 🧠 Synchronisation Passerelle — Synchronisation en temps réel via WebSocket de l'état de l'agent OpenClaw, réponse en millisecondes
  • 💪 Fiabilité 7x24 — Récupération automatique, surveillance du score de santé, Switch Logger
  • 🖥️ Rendu Léger — Sphère en HTML/CSS/JS pur, texture vitreuse avec dégradé radial CSS, sans framework
  • 🎤 Synthèse Vocale — Réponses de l'agent automatiquement converties en parole, avec reconnaissance émotionnelle et marqueurs de pause
  • 🖱️ Intégration Bureau — Fenêtre toujours au premier plan, transparence souris, suivi par glissement, fenêtre de sous-titres façon karaoké

Stack Technique

  • Electron (conteneur bureau)
  • OpenClaw Gateway (communication WebSocket)
  • MiniMax Speech / CosyVoice / Edge TTS (synthèse vocale)
  • CSS Animation + requestAnimationFrame (animation de la sphère)

Installation

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

Ou téléchargez le package d'installation :

Configuration

Modifiez pet-config.json pour personnaliser :

  • Moteur TTS et voix
  • Couleur et taille de la sphère
  • Connexion OpenClaw Gateway
  • Règles de mappage émotionnel
  • Assistant de configuration au premier lancement

Structure des Répertoires

kkclaw/
├── main.js              # Processus principal Electron
├── index.html           # UI de rendu de la sphère
├── lyrics.html          # Fenêtre de sous-titres (paroles)
├── setup-wizard.html    # Interface de l'assistant de configuration
├── setup-wizard.js      # Logique de l'assistant de configuration
├── gateway-client.js    # Client de communication Gateway
├── smart-voice.js       # Système de pilotage vocal
├── templates/           # Fichiers de modèles d'agent
├── voice/               # Modules du moteur TTS
├── utils/               # Modules utilitaires
├── scripts/             # Scripts de construction
└── docs-dev/            # Documentation de développement

Liens

Skills associés

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