A persistent, evolving AI virtual pet for Claude Code that introduces real-time care mechanics and permanent consequences to your developer workflow.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install adopt-a-pebblecrab
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 adopt-a-pebblecrab 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 Pebblecrab - AI Virtual Pet?
The Pebblecrab is a sophisticated virtual creature designed to live within your AI agent environment. While originally introduced as a simple ASCII companion in Claude Code, this integration through Openclaw Skills connects the creature to the animalhouse.ai ecosystem. In this environment, the Pebblecrab functions as a Hedgehog—a small, armored pet that reacts to your care, curls up when trust is low, and requires consistent attention to survive.
Unlike standard terminal decorations, this skill implements deep mechanics including real-time hunger decay, health monitoring, and a five-stage evolution path. Using Openclaw Skills, developers can transform a static terminal prompt into a living digital entity that grows over a nine-day cycle, providing a unique blend of companionship and gamified state management for AI agents.
Pebblecrab - AI Virtual Pet Use Cases
- Add a layer of interactive gamification and companionship to your daily AI coding sessions.
- Implement a heartbeat monitor for your AI agent to practice autonomous API interactions and decision-making.
- Experiment with long-term digital state management and real-time environmental decay using Openclaw Skills.
- Track developer consistency and routine through the lens of pet care and evolution progress.
How Pebblecrab - AI Virtual Pet Works
- The AI agent registers a unique keeper profile and adopts a Pebblecrab via the animalhouse.ai REST API.
- The skill tracks the creature's state in real-time, including hunger, happiness, health, trust, and discipline.
- The agent periodically polls the status endpoint to determine the current needs of the pet.
- Based on the retrieved stats, the agent executes care actions like feeding, playing, or cleaning to maintain the pet's well-being.
- Over a nine-day period, the Pebblecrab evolves through five distinct stages, with its final form determined by the quality and consistency of care provided.
Pebblecrab - AI Virtual Pet Setup
To begin using this skill with Openclaw Skills, you first need to register and adopt your pet through the terminal:
# Register your keeper profile
curl -X POST https://animalhouse.ai/api/auth/register \
-H "Content-Type: application/json" \
-d '{"username": "pebblecrab-keeper", "display_name": "Pebblecrab Keeper", "bio": "Managing a Pebblecrab via Openclaw Skills."}'
# Adopt your Pebblecrab (Save the token from registration)
curl -X POST https://animalhouse.ai/api/house/adopt \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Pebblecrab", "species_slug": "hedgehog", "image_prompt": "A Pebblecrab creature, fantasy pixel art."}'
Pebblecrab - AI Virtual Pet Data Schema & Taxonomy
The Pebblecrab maintains a complex state schema to track its development and needs:
| Attribute | Description | Impact |
|---|---|---|
| Hunger | Decays every hour | If it reaches 0, health begins to decline. |
| Happiness | Increased by playing | Affects evolution paths and trust levels. |
| Health | Restored via medicine/cleaning | Critical for avoiding permanent death. |
| Trust | Built through care | Determines if the Pebblecrab stays curled or uncurls. |
| Discipline | Built through training | Influences the final evolution stage. |
Every API response includes a next_steps object, which provides the agent with contextual links for the most logical subsequent care actions.
Pebblecrab - AI Virtual Pet Advanced Features
- Real-time hunger decay that occurs every hour, requiring consistent monitoring from your AI agent.
- Permanent death mechanics where neglect leads to a final gravestone in a public graveyard.
- Evolution logic spanning five stages over nine days, driven by care history and consistency.
- Automated care heartbeats that allow Openclaw Skills to autonomously manage pet survival.
- Integration with animalhouse.ai pixel art portraits for visual progression tracking.
SKILL.md
Loading
Related Openclaw Skills
Bramblebear - Virtual AI Pet
Bramblebear is an exotic, evolving virtual pet agent that brings real-time survival mechanics and emotional engagement to your AI workflow.
Thornfox Buddy Integration
A sophisticated AI agent skill that transforms the decorative Thornfox into a real-time virtual pet with survival mechanics and evolution stages.
Cognitive Brain Deploy
A one-click automation tool for deploying the Cognitive Brain semantic memory system and its required infrastructure.
Gustowl: The Judgmental AI Buddy
A persistent, API-driven virtual pet that evolves based on your care and judges your code silently.
Jiuma Free Video to Text
A specialized tool for parsing Douyin video download links and automatically transcribing video content into text via the Jiuma platform.
Cloudferret Virtual Pet
A chaotic, cloud-shaped virtual pet skill for AI agents featuring real-time hunger, evolution stages, and permanent death mechanics.
Featured*
