KKClaw Desktop Pet

What KKClaw Desktop Pet does

KKClaw shows the agent as a glass-like orb pet on the desktop. The orb changes color across 14 emotions, plays idle micro-expressions, follows the mouse cursor and reacts to the time of day. Replies can be spoken with MiniMax text-to-speech, including voice cloning from a 30-second recording and eight preset voices, with Edge TTS as a fallback engine. Five personality presets can generate AGENTS.md, SOUL.md and USER.md files for the agent.

The app also includes a Gateway guardian that restarts the gateway after three failed health checks, capped at ten restarts per hour, plus a seven-step setup wizard, model hot-swapping through CC-Switch, API key storage with Electron safeStorage, and message sync with spoken announcements for Discord, Telegram, Feishu and WeCom. It runs on Windows 10 and 11 and on macOS. In version 3.7.1, Hermes mode shows a clear error when the Hermes API server is not enabled. The README is bilingual, Chinese and English.

Key features

• Animated desktop orb with 14 emotion colors and idle micro-expressions
• Voice replies with MiniMax TTS, voice cloning and an Edge TTS fallback
• Personality presets that generate AGENTS.md, SOUL.md and USER.md
• Gateway guardian with auto-restart and a 10-point health check
• Model hot-swapping through CC-Switch
• Message sync across Discord, Telegram, Feishu and WeCom

When to use it

• Giving a Hermes or OpenClaw agent a visible desktop presence with voice
• Having new messages from chat platforms read aloud on the desktop
• Keeping a local gateway running with automatic restart and diagnostics

Who it is for: Desktop users who want an animated, voice-enabled front end for an OpenClaw or Hermes agent.

How it fits with Hermes Agent

Supports Hermes Agent through a compatibility mode, alongside OpenClaw. Hermes chat requires the Hermes API server to be enabled.

Note: Hermes support is a compatibility mode that needs the Hermes API server turned on, and the project is built mainly around OpenClaw.

FAQ