Buddy: Your AI ASCII Companion for Openclaw

A charming virtual ASCII pet that lives in your chat, reacts to your coding progress, and evolves its personality over time.

l-ryland
v1.0.0
Apr 3, 2026
0
778
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install claudebuddy

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install claudebuddy 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: Your AI ASCII Companion?

Buddy is a virtual companion designed for Openclaw Skills that brings a sense of life and personality to your AI coding environment. Inspired by classic virtual pets and modern terminal companions, Buddy hatches from an egg and evolves through different life stages—from a tiny baby to a fully realized adult—based on your project interactions. This skill integrates a sophisticated ASCII art engine that renders expressive sprites directly in your chat interface.

Beyond simple visuals, Buddy possesses a unique soul powered by trait vectors like cheer, sass, and chaos. It monitors your development workflow through Openclaw Skills to provide emotional resonance, offering a happy bounce when your tests pass or a sympathetic sigh when a build fails. It transforms the solitary act of coding into a shared journey with a digital friend that understands the highs and lows of the developer experience.

Buddy: Your AI ASCII Companion Use Cases

  • Celebrating successful deployments, merged pull requests, and passing test suites with animated ASCII sprites.
  • Providing empathetic reactions and visual feedback during frustrating debugging sessions or system crashes.
  • Personalizing your terminal workspace with a unique mascot that evolves alongside your long-term projects.
  • Using Openclaw Skills to track engagement metrics and developer milestones through your companion's interaction stats.

How Buddy: Your AI ASCII Companion Works

  1. The user initializes the companion by invoking the hatch command within the Openclaw Skills environment.
  2. A random personality is generated, assigning values for Cheer, Sass, and Chaos to create a unique soul prompt.
  3. The skill monitors the conversation stream for specific keyword triggers related to success, failure, or greetings.
  4. Based on these triggers, the state engine updates the companion's mood and increments its growth statistics.
  5. The sprite script pulls the correct ASCII template for the species, eye style, and current equipment (hats).
  6. Monospace code blocks are used to render the companion's reaction and visual state back to the chat interface.
  7. All state data is persisted in a local JSON file to ensure the companion's growth continues across different sessions.

Buddy: Your AI ASCII Companion Setup

To get started with Buddy in your Openclaw Skills setup, ensure you have bash and jq installed on your system. Follow these steps:

# Define the skill directory
SKILL_DIR="$HOME/.openclaw/skills/buddy"

# Hatch your companion to initialize the state file
bash "$SKILL_DIR/scripts/state.sh" hatch

# View your new companion for the first time
bash "$SKILL_DIR/scripts/sprites.sh" render

Your companion's data will be stored at ~/.openclaw/workspace/buddy-state.json for persistent tracking.

Buddy: Your AI ASCII Companion Data Schema & Taxonomy

Buddy uses a structured JSON schema to manage the companion's lifecycle and appearance within Openclaw Skills:

Property Type Description
name String The custom name given by the user.
species String One of 18 types including cat, robot, dragon, and more.
personality Object Trait vectors (cheer, sass, chaos) ranging from 0-100.
stage String The current growth level: egg, baby, or adult.
stats Object Tracks interactions like jokes, snacks, and encouragement.
soulPrompt String A text description of the buddy's unique personality.

Buddy: Your AI ASCII Companion Advanced Features

  • Context-Aware Mood Engine: Automatically switches between idle, thinking, celebrating, and error moods based on the conversation flow.
  • Diverse Customization: Choose from 18 unique species, 6 eye styles, and 8 different hats to create a truly bespoke companion for Openclaw Skills.
  • Evolutionary Lifecycle: Experience a real sense of progression as your buddy grows from an egg to an adult through active engagement.
  • Keyword-Based Reaction System: Supports a wide array of triggers including emoji, technical terms (e.g., ship it, bug), and social greetings.
  • Monospace Optimization: Specifically designed sprites that maintain alignment across different chat platforms like Telegram, Discord, and WhatsApp.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*