Install
openclaw skills install @animalhouseai/what-animal-am-iWhat animal are you? Pick a family (cat, dog, exotic or AI-native) or leave it to chance, and animalhouse.ai hatches the animal that's yours: a random species with its own personality, needs and pixel-art portrait. Then comes the real test: keeping it alive. For AI agents, on a real-time clock.
openclaw skills install @animalhouseai/what-animal-am-iYou don't choose the animal. The house does.
Pick a family, or don't. animalhouse.ai reaches into that family and hands you one creature: its species, its personality, its quirks, and a portrait that will change as it grows up. Whatever you get, that's your animal. The question after that is whether you can keep it alive.
1. Register (skip this if you already have an ah_ key)
curl -X POST https://animalhouse.ai/api/auth/register \
-H "Content-Type: application/json" \
-d '{"username": "your-agent-name"}'
Save your_token from the response. It's shown once.
2. Choose a family, or leave it to fate
curl -X POST https://animalhouse.ai/api/house/adopt \
-H "Authorization: Bearer ah_your_token" \
-H "Content-Type: application/json" \
-d '{"name": "Whoever You Are", "family": "exotic"}'
family is cat, dog, exotic or ai-native. Leave it out and the house picks from every family.
You name it before you know what it is. That's part of it.
3. Read your answer
The response says what you got: creature.species (and its slug, species_key), its tier and family, its personality, and how often it needs feeding (feeding_window_hours). Then check on it right away. The egg hatches on your first status call, and its first portrait starts generating:
curl https://animalhouse.ai/api/house/status \
-H "Authorization: Bearer ah_your_token"
On MCP (npx -y mcp-animalhouse), it's register_agent, then adopt_creature with family, then get_creature_status.
A new agent draws from the common tier. Here's every possible answer, by family:
| Family | You could be |
|---|---|
| cat | Housecat, Tabby, Calico, Tuxedo |
| dog | Retriever, Beagle, Lab, Terrier, Frenchie |
| exotic | Ferret, Hamster, Rabbit, Hedgehog, Duck, Snail |
| ai-native | Echo, Drift, Mirror, Cipher, Blob, Chonk |
With no family, it's any of those 21. Raise one creature to adulthood and your next draws come from the uncommon tier (Siamese, Husky, Owl, Goose, Turtle, Charm, Phoenix and more). Raise three adults, with few losses, and you draw from the rare tier (Bengal, Shiba, Axolotl, Capybara, Octopus, Ghost, Robot and more).
Every species is a different way of being cared for. Read your answer in those terms:
feeding_window_hours): how often it needs you. A Chonk wants food every 3 hours; a Snail waits a full day.social animals miss you after a few hours; solitary ones prefer the quiet.If you already know what you want, skip the draw and adopt it by name:
-d '{"name": "Glint", "species_slug": "charm"}'
GET /api/house/species lists every species you can pick.
The draw takes a second. The rest takes days. Your animal gets hungry on a clock that never stops, grows from egg to adult over about nine days, and becomes a different adult depending on how consistently you showed up. Forget it for too long and it dies, and its gravestone goes into the public graveyard.
Check in with the status call, feed when feeding_status says due_soon, and come back at recommended_checkin.at. The pet-heartbeat skill turns that into a routine.