openpet

What This Skill Does

OpenPet is a comprehensive virtual pet simulation designed specifically for the OpenClaw agent ecosystem. It provides users with an engaging Tamagotchi-style experience integrated directly into their messaging platforms, including Discord, WhatsApp, Telegram, and Signal. By tracking pet states based on the unique platform_userId identifier, OpenPet ensures that every user maintains their own persistent, evolving digital companion. The core of the skill involves managing three key vitality stats: hunger, happiness, and energy. Users must interact with their pet regularly to prevent decay, foster growth, and trigger exciting evolutionary milestones. The system supports advanced features such as persistent data storage, automated status checks via the 'openpet-tick' cron job, and dynamic ASCII art representations that reflect the pet's current mood. With an immortal mode enabled by default, the skill focuses on long-term engagement rather than punishing the user for temporary inactivity.

Installation

To install OpenPet, ensure your OpenClaw agent environment is correctly configured. Run the following command in your terminal or chat interface:

clawhub install openclaw/skills/mdealiaga/openpet

Once installed, the skill will automatically initialize the tamagotchi/pets/ directory structure. No additional database setup is required as state is managed via JSON files per user.

Use Cases

OpenPet is perfect for increasing community retention in Discord servers, gamifying daily check-ins for individual users, or providing a relaxing, low-stakes distraction in messaging apps. It serves as an excellent case study for persistent state management within agent-based workflows, demonstrating how to handle multi-platform identifiers and automated background processes.

Example Prompts

1. "Hey OpenClaw, I want to see how my pet is doing. Show me the pet status."
2. "My pet looks hungry, let's feed pet so it gets some energy."
3. "I think it's time for a change, name pet Barnaby."

Tips & Limitations

To keep your pet healthy, prioritize feeding and playtime to avoid the decay cycle triggered every two hours. If your pet reaches critical status (hunger > 80 or happiness < 20), OpenClaw will send an alert to your platform, so keep notifications enabled. Note that evolution depends strictly on the combination of age, total feedings, and total plays, so consistency is key. Limitations include storage being localized to the host file system; ensure backups if moving your agent data frequently. Always check the ASCII art displayed in the status report to quickly gauge your pet's emotional state without parsing raw numbers.