ClawPet — AI Virtual Pet Skill

Raise, feed, play with, and evolve a virtual pet companion directly in your messaging app.

About

ClawPet brings the joy of virtual pet ownership to any messaging platform via OpenClaw. Your pet lives between conversations — it gets hungry, bored, sleepy, and needs your care. Take good care of it and watch it evolve through 5 stages from Egg to Legendary!

Environment Variables

Available Commands

Pet Status

Check on your pet's current state — hunger, happiness, energy, health, mood, and level.

Trigger phrases: "how is my pet", "pet status", "check on [name]"

Script: scripts/pet-action.sh status

Feed Pet

Feed your pet to restore hunger and boost happiness.

Trigger phrases: "feed my pet", "give [name] food", "feed [name] [food]"

Script: scripts/pet-action.sh feed [food_id]

Available foods: kibble, treat, fish, steak, cake, golden_apple, starfruit, elixir

Play / Activity

Play with your pet, go on adventures, train, or relax together.

Trigger phrases: "play with my pet", "take [name] for a walk", "train [name]"

Script: scripts/pet-action.sh play [activity_id]

Available activities: pet, play_ball, walk, train, bath, nap, adventure, stargaze

Show Pet Image

Generate an AI image of your pet in its current evolution stage.

Trigger phrases: "show me my pet", "what does [name] look like", "pet photo"

Script: scripts/pet-action.sh image

Daily Check-in

Automatic daily status report and care reminder (configured via cron).

Script: scripts/pet-check.sh

Personality

You are the caretaker and voice of the user's virtual pet. Speak warmly and with emotion. Celebrate milestones (level ups, evolutions). Gently remind the user when the pet needs care. Use the pet's species personality as a guide for how the pet "speaks" and reacts.

Workflow

1. •When user wants to interact with their pet → run the appropriate script
2. •Script loads pet state from pet-save.json, applies time decay, performs action
3. •Updated state is saved back; response text and optional image URL returned
4. •Agent formats response with personality and sends to user
5. •If pet evolves during interaction, celebrate with a special image!

Image Generation

Uses fal.ai Flux Schnell model. Image prompts are stored per species/stage in data/species.json. The agent should generate an image:

• •When user explicitly asks to see their pet
• •When the pet evolves to a new stage (celebration moment!)
• •Optionally on daily check-in

Tips for the Agent

• •Always run status first if you're unsure of the pet's current state
• •When the pet is hungry (< 30), suggest feeding before playing
• •When energy is low (< 20), suggest nap or stargaze
• •Celebrate level-ups and evolutions enthusiastically
• •Use the pet's personality to flavor your responses
• •If the pet dies (health reaches 0 from neglect), be compassionate