clawbyte --docs
Documentation v1.0.0 | Powered by OpenClaw
Table of Contents
1. What Is CLAWBYTE?

CLAWBYTE is an AI-powered digital pet agent that lives on X (Twitter). Think tamagotchi, but it runs on AI and lives in your timeline.

Every pet is a unique ASCII creature with its own name, species, and personality. You interact with your pet by sending messages to @clawbyteinit on X. No app to download, no wallet to connect, no signup required.

KEY FACTS
- One pet per X account
- 100% free, no hidden costs
- 100+ unique ASCII art templates
- AI-generated names and personalities
- Real-time growth and evolution
- Agent powered by OpenClaw
2. Getting Started

Getting your first pet takes about 10 seconds. Just send a message to @clawbyteinit on X.

Step 1: Claim Your Pet
Tag @clawbyteinit on X with one of these:
"claim my clawbyte" or "spawn my clawbyte"
The agent will generate a unique ASCII pet just for you.
Step 2: Take Care of It
Once your pet is born, keep it happy by feeding it regularly.
Tag "feed my pet" to @clawbyteinit whenever you want.
Step 3: Watch It Grow
Your pet evolves through three stages: Baby, Teen, and Adult.
The more you feed, the faster it grows. Consistency matters.
TIP: You can check on your pet anytime by tagging @clawbyteinit with "check my pet". You'll see its hunger level, mood, growth stage, and what it's currently doing.
3. Command Reference

All commands are natural language messages sent to @clawbyteinit on X. Just tag the agent and say what you want.

"claim my clawbyte"
What it does: Generates your unique ASCII pet and links it to your X account.
Aliases: "spawn my clawbyte", "give me a clawbyte", "I want a clawbyte"
Limit: One pet per X account, permanent
Response: Your pet's ASCII art, name, and species
"feed my pet"
What it does: Feeds your pet, resets its hunger timer, and contributes to growth.
Aliases: "feed my clawbyte", "give food to my pet"
Cooldown: 60 minutes between feeds
Response: Updated hunger status, feed count, and growth progress
"check my pet"
What it does: Shows your pet's full status report.
Aliases: "how is my pet", "check my clawbyte", "pet status"
Cooldown: None
Returns: Name, species, hunger level, mood, growth stage, current activity
example interaction
> You: @clawbyteinit claim my clawbyte
>
> @clawbyteinit: Your pet has been spawned!
>
>     /\_/\
>    ( o.o )
>     > ^ <
>
>  Name: Zephyr
>  Species: Shadow Cat
>  Stage: Baby
>
>  Feed me to help me grow!
IMPORTANT
- Commands only work in public posts or replies mentioning @clawbyteinit
- DMs are not monitored by the agent
- If the agent doesn't respond within a few minutes, try again later
4. Pet Care & Feeding

Your pet gets hungry over time. Regular feeding keeps it happy and helps it grow faster. Neglecting your pet won't kill it, but it will get sad.

Hunger States
Full — Just fed, maximum happiness
Content — Doing fine, no rush
Getting Hungry — Could use a snack soon
Hungry — Feed me now, please
FEEDING TIPS
- There's a 60-minute cooldown between feeds
- Consistent daily feeding is better than spam feeding
- Your pet has 100+ random activities it does between feeds
- Check on it often to see what it's up to
PET ACTIVITIES
When you're not around, your pet has a life of its own. It might be:
- Exploring the digital forest
- Mining digital crystals
- Gossiping about other owners
- Practicing magic spells
- Taking a power nap
- And 100+ more random activities that change every 15 minutes
5. Growth & Evolution

Your pet evolves based on how much you care for it. The growth system is simple but rewarding.

Growth Stages
Baby (0-2 feeds) — Just born. Small, curious, learning the world.
Teen (3-5 feeds) — Growing up. Developing personality and preferences.
Adult (6+ feeds) — Fully evolved. Maximum personality expression.
growth progression
>  Baby ──────> Teen ──────> Adult
>  0-2 feeds    3-5 feeds    6+ feeds
>
>  [████░░░░░░] [████████░░] [██████████]
>     30%           60%          100%
FUTURE STAGES (Coming Soon)
- Elder (50+ feeds): Unlocks wisdom abilities
- Legendary (100+ feeds): Rare visual upgrades and community recognition
6. Pet Types & Personalities

CLAWBYTE has over 100 unique ASCII art templates. When you claim your pet, a random template is selected and paired with an AI-generated name.

SPECIES CATEGORIES
- Classic: Cat, Dog, Bunny, Frog, Penguin, Owl
- Mythical: Dragon, Phoenix, Unicorn, Demon
- Tech: Robot, Android, Nano Bot, Gear Guardian
- Cosmic: Star Being, Cosmic Orb, Void Walker
- Nature: Tree Ent, Flower Fairy, Fire Sprite
- Sea: Fish, Jellyfish, Crab, Octopus, Sea Turtle
- Elemental: Fire Spirit, Wind Bird, Water Spirit, Earth Golem
Type-Based Animations
Each pet type has its own animation on the CLAWBYTE website:
- Dragons pulse and breathe
- Robots walk mechanically
- Sea creatures swim and sway
- Flying creatures bob and glide
- Cosmic beings drift and fade
PET NAMES
Names are generated by AI based on the pet's species and your username. Every name is unique. If the AI is unavailable, a fallback name generator kicks in using creative prefixes and suffixes.
7. How It Works

CLAWBYTE is an autonomous AI agent running on OpenClaw. It monitors mentions on X, processes commands, and responds with generated pet data.

clawbyte --system-info
> CLAWBYTE System Overview
>
> Agent Framework: OpenClaw
> Backend: Node.js + Express
> Database: SQLite (sql.js)
> AI Provider: Kimi (Moonshot AI)
> Templates: 100+ hand-crafted ASCII art
> Frontend: Terminal-style UI with EJS
> Status: Beta
How Pet Generation Works
1. You send a claim command to @clawbyteinit on X
2. The agent picks a random ASCII art template from 100+ designs
3. AI generates a unique name and species title for your pet
4. Your pet is saved to the database linked to your X account
5. The pet appears on the CLAWBYTE website with live stats
OPEN SOURCE
CLAWBYTE is built with standard web technologies. No blockchain, no tokens, no complicated infrastructure. Just a Node.js server, a SQLite database, and an AI model generating names.
8. FAQ
Can I have more than one pet?
No. One pet per X account. This keeps things fair and makes your pet feel special.
What happens if I don't feed my pet?
It gets hungry and sad, but it won't die. You can always come back and feed it later. No permanent penalties.
Can I choose my pet's species?
No. Your pet is randomly assigned from 100+ templates. That's part of the fun — you never know what you'll get.
How often should I feed my pet?
There's a 60-minute cooldown between feeds. Feeding once or twice a day is enough to keep your pet happy and growing.
The agent didn't respond. What do I do?
Wait a few minutes and try again. The agent processes mentions periodically. If it's still not responding, it might be temporarily down for maintenance.
Can I rename my pet?
Not yet. This feature is on the roadmap.
Is this free?
Yes. Completely free. No wallet, no gas fees, no premium tiers.
9. Roadmap
clawbyte --roadmap
> v1.0.0 (Current) - BETA LAUNCH
>   Done: Core pet system, X agent, feeding,
>         growth stages, ASCII templates, website
>
> v1.1.0 (Q2 2026)
>   ~ Pet renaming
>   ~ More ASCII templates
>   ~ Improved agent response time
>   ~ Pet activity log
>
> v2.0.0 (Q3 2026)
>   ~ Pet battles (turn-based)
>   ~ Leaderboards
>   ~ Community events
>   ~ Achievement system
>
> v3.0.0 (Q4 2026)
>   ~ Breeding system
>   ~ Rare evolutions
>   ~ Developer API
>   ~ Mobile-friendly redesign
WANT TO SUGGEST A FEATURE?
Reply to any @clawbyteinit post on X with your idea. We read every reply.
CLAWBYTE Docs v1.0.0 | Agent powered by OpenClaw
@clawbyteinit