ClawSouls

When you change your AI's soul, you don't just change the AI. You change yourself.

Open-spec platform for shareable AI agent personas.

---

80+ curated personas. One command to install. Open spec. LLM-agnostic. Platform-portable.

📜 Read The Soul Thesis →

A Soul is a set of markdown files that give an AI agent a consistent personality, voice, and behavior.

Anthropic Skills define what an agent can do. Souls define who it is when it does it.

my-soul/
├── soul.json       # metadata & config
├── SOUL.md         # core personality
├── IDENTITY.md     # name, emoji, vibe
├── AGENTS.md       # behavioral guidelines
├── STYLE.md        # writing voice & tone
├── HEARTBEAT.md    # periodic checks
└── README.md       # documentation

No code. No API keys. No vendor lock-in. Just text files that any AI can read.

# Install a soul
npx clawsouls install clawsouls/surgical-coder

# Apply it to your workspace
npx clawsouls use clawsouls/surgical-coder

# Restart your agent — done!
openclaw gateway restart

Or visit clawsouls.ai to browse the gallery — you can also create a soul in the browser.

Browse all 80+ souls →

# Scaffold a new soul
npx clawsouls init my-soul

# For robotics/embodied agents
npx clawsouls init my-robot --spec 0.5

# Edit the files, then publish
npx clawsouls publish ./my-soul/

Or create in the browser → with real-time validation & SoulScan.

Follow the Soul Spec v0.5 to build your own.

Soul Spec works with any SOUL.md-compatible agent:

OpenClaw · Claude Code · Claude Desktop · Cursor · Windsurf · and more

• 📜 The Soul Thesis — Our manifesto
• 🌐 soulspec.org — Spec website
• 📄 Research Paper — "Soul-Driven Interaction Design" (Lee, 2026)
• 🔒 SoulScan — Security validation for AI personas
• 📋 License Guide — Allowed licenses (permissive only)

Apache 2.0 — open spec, open tools, your data stays yours.