Desktop Pet

A pixel art desktop pet (default: lobster 🦞) that roams the screen as a transparent Electron overlay.

Quick Start

CODEBLOCK0

The pet starts at the bottom center of the screen and begins roaming.

HTTP API

Local API on port 18891 (127.0.0.1 only):

• - GET /state - returns INLINECODE1
• INLINECODE2 - set state: INLINECODE3

States

State	Behavior
INLINECODE4	Gentle bob, occasional claw snap
INLINECODE5

Moves along current surface | | climbing | Transitions between floor/walls/ceiling | | fleeing | Running from cursor or active window | | working | Sits at tiny laptop with sparkle particles | | thinking | Slow sway, thought dots appear | | sleeping | Eyes closed, zzz bubbles float up | | talking | Faces user, shows speech bubble, auto-returns to idle | | snapping | Claw snap animation |

Agent Integration

Hit the API at the start of responses to make the pet face the user:

CODEBLOCK1

Set to working during long operations, thinking while reasoning.

The talking state auto-returns to idle after the bubble duration expires.

Auto-Launch (macOS)

Create a LaunchAgent for auto-start on login. Use label ai.openclaw.desktop-pet.

CODEBLOCK2

Replace APP_PATH with the absolute path to the app directory.

Customization

The pet is drawn programmatically via Canvas pixel art in index.html. To change the creature:

• - Edit lobsterBase() and lobsterFront() functions with new pixel layouts
• Colors are defined as constants at the top of the script block
• Each pixel is {x, y, w, h, color} at 3x scale

Features

• - Transparent overlay, always-on-top, click-through (except on the pet itself)
• Roams full desktop: floor, walls, ceiling
• Avoids cursor (250px radius) and frontmost window
• Right-click context menu for manual state control
• Speech bubbles with auto-sizing duration
• Pixel art drawn via Canvas (no external images needed)