KKClaw

Cute Desktop Pet AI - Emotional Companion with Voice

KKClaw is a unique AI assistant that combines productivity with companionship. Featuring an adorable fluid glass ball mascot that displays 14 different emotions, KKClaw brings personality and warmth to AI interactions. With Edge TTS voice synthesis and real-time emotional animations, it's like having a friendly companion on your desktop. GitHub: https://github.com/kk43994/kkclaw Developer: kk43994 (Community Open Source) License: MIT Platform: Windows, macOS, Linux Key Innovation: KKClaw transforms the typically sterile AI assistant experience into an emotionally engaging interaction with a living, breathing desktop pet that reacts to conversations and tasks.

Core Philosophy: "AI should be fun, friendly, and emotionally intelligent"

Why KKClaw?

Emotional Connection: 14 distinct emotions make interactions feel more natural and engaging.

Beautiful Animations: Fluid glass ball mascot with smooth, captivating animations.

Natural Voice: Edge TTS provides natural-sounding speech for hands-free interaction.

Desktop Companion: Always visible on your desktop, ready to help or just keep you company.

Key Features

$#1.
Emotional Mascot

• Fluid glass ball animation
• 14 emotion states including:
  • Happy, Excited, Content
  • Sad, Disappointed, Worried
  • Surprised, Curious, Confused
  • Thinking, Focused, Working
  • Sleepy, Idle, Relaxed
• Real-time emotion transitions
• Context-aware emotional responses

$#2.
Voice Interaction

• Edge TTS integration
• Natural voice synthesis
• Multiple voice options
• Wake word detection (optional)
• Voice command recognition

$#3.
Desktop Integration

• Always-on-top overlay
• Click-through mode
• Draggable positioning
• Minimizable to system tray
• Multi-monitor support

$#4.
AI Capabilities

• OpenClaw skill compatibility
• Task automation
• Conversation memory
• Context awareness
• Multi-model support

$#5.
Customization

• Custom emotion triggers
• Mascot appearance options
• Voice selection
• Behavior tuning
• Theme support

Installation

Windows

# Download installer from GitHub releases
# Run installer
# Launch KKClaw
# Complete setup wizard

macOS

# Download DMG from GitHub releases
# Drag to Applications folder
# Launch KKClaw
# Grant accessibility permissions

Linux

# Download AppImage
wget https://github.com/kk43994/kkclaw/releases/latest/download/KKClaw-linux-x64.AppImage
chmod +x KKClaw-linux-x64.AppImage
./KKClaw-linux-x64.AppImage

From Source

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

Configuration

config.json

{
  "mascot": {
    "position": { "x": 100, "y": 100 },
    "size": "medium",
    "alwaysOnTop": true,
    "clickThrough": false
  },
  "emotions": {
    "enabled": true,
    "sensitivity": 0.7,
    "transitionSpeed": "smooth"
  },
  "voice": {
    "enabled": true,
    "provider": "edge-tts",
    "voice": "en-US-AriaNeural",
    "speed": 1.0,
    "wakeWord": false
  },
  "ai": {
    "provider": "openai",
    "model": "gpt-4o-mini"
  }
}

Emotion System

Emotion Triggers

Custom Triggers

{
  "customEmotions": {
    "celebrate": {
      "trigger": "task completed with excellence",
      "emotion": "excited",
      "duration": 5
    },
    "encourage": {
      "trigger": "user seems frustrated",
      "emotion": "content",
      "duration": 10
    }
  }
}

Pricing

Free: KKClaw is completely free and open source under MIT license. You only pay for the AI models you use through their respective providers.

Edge TTS: Free to use for personal projects.

System Requirements

Use Cases

Companion AI Assistant

Have a friendly AI companion that not only helps with tasks but also provides emotional engagement.

Emotional Support AI

Interact with an AI that understands and responds to emotional context.

Desktop Entertainment

Enjoy watching your animated mascot react and respond throughout your day.

Productivity Companion

Stay motivated with an AI that celebrates your successes and encourages you.

Voice-Based Interaction

Use natural voice commands for hands-free operation.

Casual AI Conversations

Have friendly chats with your desktop pet during breaks.

Stress Relief Companion

The calming animations and friendly presence can help reduce stress.

Community and Support

• GitHub: https://github.com/kk43994/kkclaw
• Documentation: https://github.com/kk43994/kkclaw#readme
• Issues: GitHub Issues tab
• Discussions: GitHub Discussions tab

Quick Start Guide

Get KKClaw up and running quickly.

Step 1: Install

cd kkclaw
npm install
npx kkclaw setup

Step 2: Configure

Set your AI model and API key in the configuration.

Step 3: Connect and Go

Link your messaging platform and start using your AI agent.

Full documentation: https://github.com/kk43994/kkclaw#readme

FAQ

Is KKClaw free to use?

Yes, KKClaw is free and open source (MIT license). You only pay for AI model API costs if using external models.

What are the system requirements for KKClaw?

KKClaw requires 1GB RAM of RAM minimum. Runtime: Electron. It runs on Windows, macOS, and Linux.

Can I self-host KKClaw?

Yes. KKClaw is open source (MIT) and can be self-hosted on your own hardware. Clone the repository from GitHub and follow the installation guide.

How does KKClaw compare to OpenClaw?

KKClaw offers a different approach compared to OpenClaw. While OpenClaw provides the largest ecosystem with 13,729+ skills and maximum flexibility, KKClaw focuses on personal assistant. Choose KKClaw if you prioritize its specific features; choose OpenClaw for the broadest compatibility and community support.

Is KKClaw suitable for beginners?

KKClaw requires some technical knowledge to set up (Electron). If you are a beginner, consider starting with QClaw (one-click install) or MaxClaw (cloud-based, no setup) first, then graduate to KKClaw as you gain experience.

License

MIT License - Free for personal and commercial use.

Tags

ai-agent, desktop-pet, emotional-ai, edge-tts, animation, companion, voice, openclaw