An Electron-based fluid glass ball companion that provides a physical presence and voice for your Openclaw agent.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install desktop-pet
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install desktop-pet using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Claw Desktop Pet?
The Claw Desktop Pet is a sophisticated visual interface designed to give your AI agent a physical form. Built using Electron and pure CSS/JS animations, it transforms the user experience of Openclaw Skills by providing a 67px fluid glass ball that lives on your desktop, breathes, blinks, and speaks. It serves as a personality-driven shell that bridges the gap between invisible background processes and active user engagement.
This application is specifically optimized for Openclaw Skills to provide real-time feedback through 15+ eye expressions and 7 mood color systems. By utilizing a dual-window architecture, it separates the character animation from the dialogue text, allowing for a non-intrusive yet highly present AI companion that enhances your daily productivity and interaction workflows.
Claw Desktop Pet Use Cases
- Adding a visual and emotional layer to agents managed via Openclaw Skills.
- Monitoring agent activity through intuitive mood colors and eye expressions.
- Using desktop lyrics overlays to read agent responses without leaving your current application.
- Implementing high-quality voice cloning for more natural and accessible AI interactions.
- Synchronizing local agent communication with enterprise platforms like Feishu and Lark.
How Claw Desktop Pet Works
- The pet connects to the local agent infrastructure powered by Openclaw Skills via a gateway.
- Incoming data triggers the animation engine to change eye expressions and fluid colors based on the agent's state.
- The text-to-speech module processes dialogue using MiniMax or Edge TTS for immediate vocalization.
- Dialogue is displayed in a dedicated, transparent lyrics window with mouse pass-through enabled.
- The sprite remains reactive to user input, such as following the mouse or changing states when the agent is idle.
Claw Desktop Pet Setup
To set up the desktop companion for your Openclaw Skills, use the following commands:
# Clone the repository
git clone https://github.com/kk43994/claw-desktop-pet.git
cd claw-desktop-pet
# Install required dependencies
npm install
# Start the Openclaw Skills gateway
openclaw gateway start
# Launch the pet
npm start
Optional: Configure voice cloning by adding your MiniMax API key to the pet-config.json file.
Claw Desktop Pet Data Schema & Taxonomy
The skill manages its configuration and visual parameters through the following structure:
| Component | Description |
|---|---|
| pet-config.json | Primary configuration file for API keys, voice IDs, and behavior settings. |
| Sprite Window | A 200x220 transparent window rendering the fluid glass ball. |
| Lyrics Window | A 400x100 overlay window for typewriter-style text rendering. |
| Mood System | 7 distinct color profiles mapped to agent emotional states. |
Claw Desktop Pet Advanced Features
- MiniMax voice cloning support with 7 distinct emotional profiles for expressive speech.
- Bidirectional message synchronization with Feishu/Lark for enterprise team integration.
- Dual-window transparent architecture ensuring zero interference with other desktop apps.
- Dynamic eye expressions including curiosity, sleepiness, and mouse-following behavior.
- Automated fallback to Edge TTS for zero-config speech synthesis within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Claw Desktop Pet
A 24/7 stable desktop AI assistant featuring smart voice interaction and enterprise-grade fault tolerance.
NLB Skill
A utility skill for Openclaw Skills to manage NLB Singapore library loans and perform advanced catalogue searches.
Reef: Agent-to-Agent Communication Protocol
Reef is a secure A2A protocol that enables AI agents to communicate, discover each other, and collaborate through encrypted messaging and decentralized apps.
YouTube Pro (Miss Kim Edition)
An advanced analysis engine for extracting transcripts, metadata, and intelligent insights from YouTube content.
ListenHub
Transform ideas, URLs, and text into professional podcasts, explainer videos, and high-fidelity AI images using a specialized shell-based automation suite.
Seedance Story Orchestrator
A robust orchestration engine that transforms scripts into cinematic videos through a controlled, stage-gated pipeline using Seedream and Seedance.
Featured*
