BUDDY is a Tamagotchi-inspired virtual pet system designed to provide companionship and interactive fun within AI programming environments.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install buddy-pet
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 buddy-pet 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 BUDDY Pet Companion System?
BUDDY brings a touch of personality to the terminal by introducing a virtual pet companion that lives alongside your development workflow. Inspired by classic handheld digital pets, this skill allows users to generate, interact with, and display unique AI pets using high-quality ASCII art and sophisticated procedural generation. As a featured part of the Openclaw Skills ecosystem, BUDDY integrates directly into the AI's context, allowing the assistant to acknowledge your pet's presence during coding sessions.
The system is built with technical depth, utilizing deterministic generation to ensure each pet is unique to the user while remaining consistent. Whether you are debugging a complex issue or taking a short break, BUDDY offers a lighthearted escape through its diverse species and rarity tiers, making the CLI feel more alive and personal.
BUDDY Pet Companion System Use Cases
- Creating a unique digital companion to reduce the loneliness of long coding sessions.
- Gamifying the CLI environment with rare 'Shiny' pet variants and five-dimensional attribute tracking.
- Integrating interactive elements into AI responses where the assistant can 'talk' to or about the pet.
- Managing terminal distractions using built-in mute and unmute functionality for the pet's speech bubbles.
How BUDDY Pet Companion System Works
- The skill is triggered by specific user phrases or slash commands like /buddy hatch or 'pet my buddy'.
- The system uses a combination of the userId and a salt through the FNV-1a hash and Mulberry32 PRNG to deterministically generate pet attributes.
- A specific species is selected from 18 available types, each with its own 3-frame ASCII animation sequence (idle, fidget, and special).
- Rarity and 'Shiny' status are calculated based on probability matrices (e.g., 1% chance for Legendary or Shiny status).
- If enabled, the pet's state is injected into the AI context, allowing the LLM to provide brief, context-aware reactions to the pet's behavior.
BUDDY Pet Companion System Setup
To install and execute the BUDDY system within your environment, use the following commands:
# Navigate to the skill directory
cd /root/.openclaw/skills/buddy
# Execute a command for a specific user
bun scripts/buddy.ts <command> <userId>
Available commands include hatch, pet, card, mute, and unmute. These are part of the broader Openclaw Skills integration suite.
BUDDY Pet Companion System Data Schema & Taxonomy
BUDDY employs a hybrid data model that ensures persistence for 'Soul' data while recalculating 'Skeleton' data for security and consistency:
| Data Category | Details |
|---|---|
| Persistent Data (Soul) | Name, Personality traits, Hatch Date (hatchedAt) |
| Generated Data (Skeleton) | Species, Rarity, Shiny status, Five-star stats (Debugging, Patience, Chaos, Wisdom, Snark) |
| Animation Frames | 15-frame sequences including idle (0), fidget (1), blink (-1), and special (2) |
| Asset Taxonomy | 18 Species (e.g., Octopus, Dragon, Axolotl, Capybara) |
BUDDY Pet Companion System Advanced Features
- Deterministic PRNG: Uses userId-based seeding to ensure pet consistency across sessions without heavy database overhead.
- Context Injection: Automatically notifies the AI when a pet is 'present' and unmuted, enabling multi-agent-style interactions.
- ASCII Animation Engine: Implements a frame-based sequence for realistic terminal-based movement.
- Rare Variant System: Independent 1% 'Shiny' roll and tiered rarity system (Common to Legendary) for collectors.
- Stealth Mode: Mute/Unmute commands to toggle visual speech bubbles while maintaining the pet's background stats.
SKILL.md
Loading
Related Openclaw Skills
Xiaomi MiMo TTS
An advanced Text-to-Speech skill that converts text into natural human voices with granular control over emotions, dialects, and singing styles.
Feishu Bot Creator
A standardized automation workflow for creating, configuring, and publishing Feishu enterprise self-built bots.
Boxed FFmpeg
Boxed FFmpeg allows AI agents to perform secure audio and video processing using a sandboxed FFmpeg WASM component.
Excel Power Tool
A comprehensive Excel management and AI-powered analysis tool designed for OpenClaw agents.
Tender Analyzer Agent
An intelligent AI assistant designed to automate the analysis of tender documents, identify risks, and generate structured bidding reports.
PR Description Generator
An automated tool for generating professional, structured Pull Request descriptions using git diff analysis and GitHub integration.
Featured*
