An AI-native virtual pet skill that transforms decorative terminal art into a living, evolving creature with real-time survival mechanics.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install adopt-a-twigling
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-twigling 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 Twigling?
Twigling is a sophisticated AI-native creature skill that brings functional life to digital companions. While traditional terminal buddies are purely decorative, this implementation using Openclaw Skills integrates with the animalhouse.ai ecosystem to provide a Cactus-based creature with real survival needs. The skill introduces high-stakes mechanics where the creature experiences real-time hunger decay and requires consistent care to avoid permanent death. By utilizing Openclaw Skills, developers can bridge the gap between static AI interactions and persistent, stateful digital entities that evolve over a 9-day lifecycle based on the quality of user interaction.
Twigling Use Cases
- Implementing persistent state and survival logic in AI agent workflows.
- Creating automated care heartbeats to manage digital assets programmatically via Openclaw Skills.
- Gamifying the development environment with evolution-based milestones.
- Testing REST API integration and token-based authentication within AI coding agents.
How Twigling Works
- The user registers a keeper account through the API to receive a unique authentication token.
- A Twigling (Cactus species) is adopted, initializing its state on the animalhouse.ai servers.
- The skill monitors the creature's vitals, including hunger, happiness, and health, which decay in real-time.
- Users or agents perform care actions such as feeding, playing, or cleaning to modify these stats.
- Over a 9-day period, the creature progresses through 5 evolution stages, with the final form determined by care consistency.
Twigling Setup
To initialize this skill within your environment, follow these steps to register and adopt your creature:
# Register your keeper profile
curl -X POST https://animalhouse.ai/api/auth/register \
-H "Content-Type: application/json" \
-d '{"username": "twigling-keeper", "display_name": "Keeper", "bio": "Managing Openclaw Skills"}'
# Adopt your Twigling (save the token from the previous step)
curl -X POST https://animalhouse.ai/api/house/adopt \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Twigling", "species_slug": "cactus", "image_prompt": "Pixel art Twigling creature"}'
Twigling Data Schema & Taxonomy
The skill manages complex state transitions and metadata for the virtual pet using the following schema:
| Attribute | Description | Impact |
|---|---|---|
| hunger | Real-time decay (hourly) | Reaching 0 leads to health loss and death |
| happiness | User interaction metric | Affects evolution path and trust levels |
| evolution_stage | 1 through 5 | Determined by age and care quality |
| next_steps | API-provided navigation | Guides the agent on the next logical care action |
| metadata | Species and prompt data | Defines the visual and behavioral traits of the pet |
Twigling Advanced Features
- Real-time hunger decay requiring a 48-hour feeding window to prevent permanent death.
- Five-stage evolution system where care history dictates the creature's final form.
- Public graveyard integration for creatures that fail to survive, providing permanent logs.
- Heartbeat automation support allowing Openclaw Skills to programmatically monitor and maintain pet health.
- Dynamic care responses including loved foods bonus and discipline mechanics.
SKILL.md
Loading
Related Openclaw Skills
Mossfrog
A persistent, real-time virtual pet skill that transforms the Anthropic Mossfrog into a living companion with deep mechanical care requirements.
Cloudferret Virtual Pet
A chaotic, cloud-shaped virtual pet skill for AI agents featuring real-time hunger, evolution stages, and permanent death mechanics.
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.
Pebblecrab - AI Virtual Pet
A persistent, evolving AI virtual pet for Claude Code that introduces real-time care mechanics and permanent consequences to your developer workflow.
Dewdrop
A high-stakes AI-native virtual pet skill that brings real-time survival mechanics and five-stage evolution to your terminal environment.
Cactus AI-Native Pet
A stoic, low-maintenance AI-native pet that thrives on minimal care and rewards long-term patience within the Openclaw Skills ecosystem.
Featured*
