← Back to Skills Marketplace
408
Downloads
2
Stars
2
Active Installs
10
Versions
Install in OpenClaw
/install openclaw-spirits
Description
Companion spirit system for OpenClaw agents. Every user gets a unique spirit creature — deterministically generated from their identity (24 species, 5 rariti...
Usage Guidance
This package appears to be what it says: a deterministic 'spirit' companion that runs entirely from local scripts and the agent's LLM. Before installing, consider: (1) Privacy — the skill seeds generation with a user ID (open_id, Telegram/Discord ID, or username) and stores companion.json in the skill directory; if you don't want those identifiers used/stored, don't install. (2) Passive messages — the skill explicitly directs the agent to sometimes send short unsolicited one-liners; if you prefer no autonomous chatter, disable or avoid enabling the skill. (3) Review soul.js and other scripts yourself (or request their full source) to confirm they do not make external network calls or require API keys; the SKILL.md claims no network activity, but verifying the actual scripts eliminates residual doubt.
Capability Assessment
Purpose & Capability
Name/description, assets (sprites.json, companion.json), and scripts (generate.js, render.js, display.js, soul.js) align with a deterministic companion generator. No unrelated credentials, binaries, or platform-level access are requested.
Instruction Scope
Runtime instructions ask the agent to run local node scripts, call the agent's LLM to generate the 'soul', and save companion data under {baseDir}/assets/companion.json — all consistent with the stated purpose. The skill also instructs the agent to occasionally initiate brief passive messages; that is scope-appropriate for a 'companion' skill but could be considered unsolicited behavior by some users.
Install Mechanism
No install spec provided (instruction-only from registry). Code and assets are packaged with the skill; there are no external download/install steps or third-party package pulls in the manifest.
Credentials
Skill declares no required env vars or credentials, which matches the instructions. It does require a user identifier (Feishu open_id, Telegram ID, Discord ID, or username) to deterministically generate a spirit — this means PII-like identifiers will be used as seed input and stored in an in-skill companion.json; consider privacy implications of using platform IDs.
Persistence & Privilege
always:false and model invocation allowed (platform default). The skill's guidance asks for occasional passive appearances (agent-initiated one-liners), but this autonomy is not combined with broad credentials or system changes. No evidence the skill modifies other skills or system-wide configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-spirits - After installation, invoke the skill by name or use
/openclaw-spirits - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.3.2
Improve searchability: better description keywords and tags for ClawHub vector search
v1.3.1
Fix: aligned all file paths (SKILL.md, SPEC.md, spirit.sh) to use assets/companion.json consistently. Fixed spirit.sh summon flow to match soul.js subcommand interface. Removed all stale references to external paths.
v1.3.0
Security fix: removed child_process, process.env, external writes. soul.js rewritten as pure prompt/save/show tool. All file writes restricted to assets/ directory. Fixed soul.js CLI interface to match SKILL.md. Unified commands to spirit.
v1.2.3
v1.2.3: Updated description — spirit pet system, tribute to Anthropic and Claude Code Buddy
v1.2.2
v1.2.2: Users can talk to spirit by just calling its name — no spirit talk prefix needed
v1.2.1
v1.2.1: Passive appearances now always include ASCII sprite (presence > text-only). spirit talk shows sprite every 3-5 exchanges.
v1.2.0
v1.2: Spirit voice design — speaks in human language but extremely brief (one sentence, half sentence, or just '...'). Personality-driven voice examples by top stat. Clear examples for 5 reaction scenarios.
v1.1.1
v1.1.1: README updated — commands now use spirit (not buddy), added interaction guide, bilingual rarity names, personality-driven response examples
v1.1.0
v1.1: Command renamed buddy→spirit. SKILL.md completely rewritten with explicit agent instructions: (1) must show FULL spirit card on first summon, (2) detailed passive interaction rules, (3) personality-based spirit voice guidelines, (4) bilingual display format with exact template. Fixed companion file path.
v1.0.0
Initial release: 24 spirit species (12 Living + 12 Elemental), 5 rarities, bilingual (zh/en), ASCII sprites, deterministic generation, full interaction commands
Metadata
Frequently Asked Questions
What is Openclaw Spirits?
Companion spirit system for OpenClaw agents. Every user gets a unique spirit creature — deterministically generated from their identity (24 species, 5 rariti... It is an AI Agent Skill for Claude Code / OpenClaw, with 408 downloads so far.
How do I install Openclaw Spirits?
Run "/install openclaw-spirits" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Openclaw Spirits free?
Yes, Openclaw Spirits is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Openclaw Spirits support?
Openclaw Spirits is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Openclaw Spirits?
It is built and maintained by ahaaiclub (@ahaaiclub); the current version is v1.3.2.
More Skills