🦞 Claw Desktop Pet — Give OpenClaw a Body
A desktop AI companion that gives your OpenClaw agent a physical presence on your desktop.
What is it?
A 67px fluid glass ball that lives on your desktop — it breathes, blinks, speaks, and reacts. Messages appear like floating desktop lyrics with white glow text. Your agent isn't invisible anymore.
Features
- 🫧 Fluid Glass Ball — 67px sphere with 7 mood color systems
- 👀 15+ Eye Expressions — blink, curious, sleepy, surprised, follow mouse
- 🎵 Desktop Lyrics — typewriter text, white glow, mouse pass-through
- 🎤 Voice Cloning — MiniMax Speech with 7 emotions, auto detection
- 🎨 Dual Window Architecture — sprite + lyrics, fully transparent
- ⚫ Offline/Online Animation — gray sleep → colorful revival with particles
- 💬 Feishu/Lark Sync — bidirectional message sync
- 🛡️ Enterprise Stability — auto-restart, error handling, performance monitoring
Quick Start
# Clone the project
git clone https://github.com/kk43994/claw-desktop-pet.git
cd claw-desktop-pet
# Install dependencies
npm install
# Start (basic mode)
npm start
# Full AI mode — requires OpenClaw gateway running
openclaw gateway start
npm start
Voice Setup (Optional)
MiniMax Speech (Recommended — voice cloning + emotions)
Set your MiniMax API key in pet-config.json:
{
"minimax": {
"apiKey": "your-api-key",
"voiceId": "your-cloned-voice-id"
}
}
Fallback: Edge TTS (Free, no setup)
Works out of the box — uses Microsoft Edge TTS as fallback.
Architecture
┌── Sprite Window (200×220) ──┐ ┌── Lyrics Window (400×100) ──┐
│ 67px fluid glass ball │ │ Desktop lyrics overlay │
│ 15+ eye expressions │ │ Typewriter + white glow │
│ SVG icon toolbar │ │ Mouse pass-through │
│ 7 mood color systems │ │ Auto-fade after voice done │
└──────────────────────────────┘ └──────────────────────────────┘
Tech Stack
- Electron — Desktop framework (dual transparent windows)
- OpenClaw — AI dialogue engine
- MiniMax Speech — Voice cloning + emotion TTS
- Pure CSS/JS — All animations, no sprite sheets
Design Philosophy
- Air-feel UI — Like desktop lyrics, doesn't interfere with work
- iOS minimalism — Simple, elegant, icon-only buttons
- Lobster identity — Expressed through red-orange fluid color, not literal appendages
- References — Nomi robot, AIBI robot, Bunny Hole
Links
Made with ❤️ and 🦞 by zhouk (kk43994)
1---2name: desktop-pet3description: Give OpenClaw a body — a tiny fluid glass ball desktop pet with voice cloning, 15+ eye expressions, desktop lyrics overlay, and 7 mood colors. Electron-based, pure CSS/JS animation.4---56# 🦞 Claw Desktop Pet — Give OpenClaw a Body78A desktop AI companion that gives your OpenClaw agent a physical presence on your desktop.910## What is it?1112A 67px fluid glass ball that lives on your desktop — it breathes, blinks, speaks, and reacts. Messages appear like floating desktop lyrics with white glow text. Your agent isn't invisible anymore.1314## Features1516- 🫧 **Fluid Glass Ball** — 67px sphere with 7 mood color systems17- 👀 **15+ Eye Expressions** — blink, curious, sleepy, surprised, follow mouse18- 🎵 **Desktop Lyrics** — typewriter text, white glow, mouse pass-through19- 🎤 **Voice Cloning** — MiniMax Speech with 7 emotions, auto detection20- 🎨 **Dual Window Architecture** — sprite + lyrics, fully transparent21- ⚫ **Offline/Online Animation** — gray sleep → colorful revival with particles22- 💬 **Feishu/Lark Sync** — bidirectional message sync23- 🛡️ **Enterprise Stability** — auto-restart, error handling, performance monitoring2425## Quick Start2627```bash28# Clone the project29git clone https://github.com/kk43994/claw-desktop-pet.git30cd claw-desktop-pet3132# Install dependencies33npm install3435# Start (basic mode)36npm start3738# Full AI mode — requires OpenClaw gateway running39openclaw gateway start40npm start41```4243## Voice Setup (Optional)4445### MiniMax Speech (Recommended — voice cloning + emotions)46Set your MiniMax API key in `pet-config.json`:47```json48{49 "minimax": {50 "apiKey": "your-api-key",51 "voiceId": "your-cloned-voice-id"52 }53}54```5556### Fallback: Edge TTS (Free, no setup)57Works out of the box — uses Microsoft Edge TTS as fallback.5859## Architecture6061```62┌── Sprite Window (200×220) ──┐ ┌── Lyrics Window (400×100) ──┐63│ 67px fluid glass ball │ │ Desktop lyrics overlay │64│ 15+ eye expressions │ │ Typewriter + white glow │65│ SVG icon toolbar │ │ Mouse pass-through │66│ 7 mood color systems │ │ Auto-fade after voice done │67└──────────────────────────────┘ └──────────────────────────────┘68```6970## Tech Stack7172- **Electron** — Desktop framework (dual transparent windows)73- **OpenClaw** — AI dialogue engine74- **MiniMax Speech** — Voice cloning + emotion TTS75- **Pure CSS/JS** — All animations, no sprite sheets7677## Design Philosophy7879- **Air-feel UI** — Like desktop lyrics, doesn't interfere with work80- **iOS minimalism** — Simple, elegant, icon-only buttons81- **Lobster identity** — Expressed through red-orange fluid color, not literal appendages82- **References** — Nomi robot, AIBI robot, Bunny Hole8384## Links8586- 🔗 GitHub: https://github.com/kk43994/claw-desktop-pet87- 📖 Full documentation in README88- 📄 MIT License8990---9192Made with ❤️ and 🦞 by zhouk (kk43994)
kbarbel640-del