leozhaorx/openclaw-desk-pet

OpenClaw Desk Pet is a native macOS app that turns the invisible work of an AI agent called OpenClaw into a small animated cat sitting on your desktop. The idea is simple: instead of repeatedly switching back to a terminal or dashboard just to check whether an AI agent is still working, you glance at the cat. If it is sitting calmly, the agent is idle. If it stands up and gets busy, a task has started. If it looks like it is checking a phone, it is still working on something. The cat does not do any of the actual AI work itself. OpenClaw remains responsible for real tasks such as running tools, thinking through steps, and spawning sub tasks, while the desk pet only listens to a stream of status events coming from OpenClaw's Gateway and translates them into matching animations, such as thinking, calling a tool, finishing a task, or falling asleep when nothing is happening. You can also start new tasks directly from the desktop, either by clicking a preset quick task button or by typing a request, and that request is sent back to OpenClaw to actually carry out. If the live event stream from the Gateway is temporarily unavailable, the app falls back to reading recent local session files so the cat's behavior stays reasonably accurate rather than freezing. All of the animation switching happens at natural break points in the cat's movement clips, so the transitions between states look smooth rather than jumpy. Setup and configuration are handled through a small local web page rather than editing files by hand, letting you set the OpenClaw folder location, the Gateway address, a startup script, and the desktop's quick task buttons, with changes saved automatically. The project requires macOS 13 or newer, Swift, Python, and an existing OpenClaw installation to connect to. It is open source and released under the MIT license.