Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
A pixel art desktop pet that runs as a transparent, always-on-top Electron overlay on macOS. The pet roams the screen, climbs walls and ceilings, avoids the cursor and active windows, and exposes a local HTTP API on port 18891 so agents can change its animation state programmatically.
Unlike static widgets or notification popups, the pet gives continuous ambient visual feedback about agent state without interrupting focus or requiring window switching.
When to use it
- Visual indicator when an AI agent is running a long task
- Desktop companion during extended coding or writing sessions
- Mascot that shows thinking or working states during agent activity
- Auto-launching startup buddy configured via macOS LaunchAgent
- Screen element with speech bubbles driven by agent curl calls
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: 'Run a long analysis task and keep me updated'
- 1Start the pet with 'npx electron .' in the skill app directory
- 2POST /state with {"state":"working"} when the task begins
- 3POST /state with {"state":"thinking"} while reasoning
- 4POST /state with {"state":"talking","bubble":"done!"} when ready to report results
Pet animates through working, thinking, and talking states, then auto-returns to idle