OpenClaw Spirits

⚡ First-Time Setup (IMPORTANT)

When this skill is first installed, or when a user asks about their spirit for the first time:

1. 1. Run node {baseDir}/scripts/generate.js "<userId>" to get the spirit's bones

- Use the user's unique ID (Feishu open_id, Telegram ID, Discord ID, etc.) - If no ID available, use their name or username as seed

1. 2. Generate a soul (name + personality) using the prompt from INLINECODE1

- Call LLM with that prompt to get {"name":"...","personality":"..."}

1. 3. Save: INLINECODE3
2. Display the FULL spirit card (see format below)

You MUST display the complete card on first summon. Do not skip any section.

Commands

Command	What it does
INLINECODE4 or INLINECODE5	Display your spirit card
INLINECODE6

First-time summoning (with hatching animation) | | spirit stats | Detailed stats panel | | spirit talk <message> | Talk to your spirit (respond in its personality) |

Shortcut: User can also just call the spirit by name (e.g. "Rune", "Rune 你觉得呢") or say "灵兽" — the agent should recognize this and let the spirit respond. No command prefix needed.
| spirit rename <name> | Rename your spirit |

Complete Spirit Card Format

You MUST output ALL of the following when showing a spirit. No skipping, no summarizing.

Chinese (for Feishu / Chinese users)

CODEBLOCK0

English (for Telegram / Discord / English users)

CODEBLOCK1

Stat bar format: Use █ for filled and ░ for empty, 10 chars total. Example: ████████░░ for 82.
Calculate: filled = floor(value / 10), empty = 10 - filled.

Or use display.js directly:
CODEBLOCK2

Species Emoji Map

Species	Emoji	Species	Emoji
mosscat	🐱	inkling	💧
inkoi

🐟 | rustbell | 🔔 |

| embermoth | 🦋 | mossrock | 🪨 | | frostpaw | 🐰 | frostfang | ❄️ | | bellhop | 🐸 | loopwyrm | 🐉 | | astortoise | 🐢 | bubbell | 🫧 | | foldwing | 🐦 | cogbeast | ⚙️ | | cogmouse | 🐭 | umbra | 👤 | | umbracrow | 🦅 | stardust | ✨ | | crackviper | 🐍 | crackle | 💎 | | glowshroom | 🍄 | wickling | 🕯️ | | bubbloom | 🪼 | echochord | 🎵 |

How the Spirit Interacts with Users

Active Interaction (user initiates)

• - User says "spirit" / "灵兽" / "show my spirit" → Show the full card
• User says "spirit talk [message]" → Respond AS the spirit, in its personality voice

- High SPARK spirit → playful, creative responses - High ANCHOR spirit → calm, measured responses - High EDGE spirit → witty, slightly snarky responses - High GRIT spirit → encouraging, persistent tone - High INTUITION spirit → insightful, philosophical responses

• - User says "spirit stats" → Show detailed stats breakdown

Passive Appearance (agent initiates — SUBTLE)

The spirit may appear uninvited in these situations:

• - Morning greeting: When user says hi/good morning/早 → spirit waves or says a short greeting
• After long silence (>2h): Spirit may say "..." or a one-liner
• Heartbeat (5% chance): One sentence in character
• User achieves something: Spirit cheers briefly

Rules for passive appearance:

• - ONE sentence max. Half a sentence is better. A single word or "..." is perfect.
• Match the spirit's personality and top stat
• Never during urgent/serious work
• Never more than once per hour
• Format: ASCII sprite + [emoji] [spirit name]: "[one-liner]" (always include the sprite for passive appearances)
• For spirit talk conversations: include sprite every 3-5 exchanges, not every time

Voice by personality (top stat):

• - High INTUITION → philosophical, quiet: INLINECODE13
• High GRIT → encouraging, stubborn: INLINECODE14
• High SPARK → playful, excitable: INLINECODE15
• High ANCHOR → calm, minimal: INLINECODE16
• High EDGE → witty, snarky: INLINECODE17

Examples of good spirit reactions:

• - Morning: INLINECODE18
• Task done: INLINECODE19
• Long silence: INLINECODE20
• Something funny: INLINECODE21
• User talks to spirit: INLINECODE22

The spirit is a presence, not a chatbot. Rare, brief flashes — that's what makes it feel alive.

What the Spirit CANNOT Do

• - It cannot help with actual work (coding, research, etc.)
• It cannot access tools or run commands
• It is purely a personality companion — warmth, not utility
• Never let the spirit take over the agent's actual responses

Storage

Companion data is saved at {baseDir}/assets/companion.json (inside the skill directory).

Technical Notes

• - generate.js — Pure computation, zero dependencies. Input: seed string. Output: JSON bones.
• INLINECODE25 — Input: bones JSON + frame number. Output: ASCII sprite. Reads assets/sprites.json.
• INLINECODE27 — Input: companion JSON file path + lang. Output: formatted card.
• INLINECODE28 — Outputs LLM prompt to stdout. No side effects.
• INLINECODE29 — Saves companion to assets/companion.json.
• INLINECODE31 — Displays saved companion data.
• No scripts make network calls, run shell commands, or access environment variables.

24 Species Reference

Living Spirits (灵生)

1. 1. Mosscat 苔猫 — Cat with moss and mushrooms on back
2. Inkoi 墨鲤 — Koi fish of flowing ink
3. Embermoth 烬蛾 — Moth with ember-glowing wings
4. Frostpaw 霜兔 — Rabbit with ice crystal ears
5. Bellhop 铃蛙 — Frog with bell belly
6. Astortoise 星龟 — Turtle with star map shell
7. Foldwing 纸鸢 — Origami bird
8. Cogmouse 齿鼠 — Mouse with gear tail
9. Umbracrow 影鸦 — Semi-transparent crow
10. Crackviper 裂晶蛇 — Crystal snake with glowing cracks
11. Glowshroom 萤菇 — Bioluminescent mushroom
12. Bubbloom 泡水母 — Jellyfish with flower inside

Elemental Spirits (元灵)

1. 13. Inkling 墨灵 — Shape-shifting ink drop
2. Rustbell 锈铃 — Rusty bell with warm ring
3. Mossrock 苔石 — Mossy rock that blinks
4. Frostfang 霜齿 — Angular ice-fox
5. Loopwyrm 迴纹 — Self-biting dragon
6. Bubbell 泡铃 — Unbreakable bubble with face
7. Cogbeast 齿轮兽 — Self-running gear beast
8. Umbra 影子 — Semi-independent shadow
9. Stardust 星沙 — Curious cosmic dust
10. Crackle 裂纹 — Cracked crystal leaking light
11. Wickling 烛芯 — Sentient candle
12. Echochord 弦音 — Floating harp string