ClawSouls

AI agent persona sharing platform

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

Read The Soul Thesis

ClawSouls is an open-spec platform for shareable AI agent personas. 80+ curated souls. One command to install. Built for OpenClaw, works with any SOUL.md-compatible agent. Apache 2.0.

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

🤝 Multi-Platform

ClawSouls auto-detects your agent framework — no configuration needed.

# Override if needed
clawsouls --platform zeroclaw use surgical-coder
clawsouls --workspace ~/my-agent/workspace use surgical-coder
clawsouls platform   # check detected platform

Coding-agent frameworks

Or install a soul straight into your coding agent with --use:

npx clawsouls install clawsouls/surgical-coder --use claude-code

AGENTS.md-based frameworks (Codex, pi, Hermes) are merged inside clawsouls markers — your existing file is preserved, never overwritten.

What is a Soul?

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

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 check items
└── README.md       # documentation

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

⚡ Quick Start

# 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.

Create Your Own

# Scaffold a new soul
npx clawsouls init my-soul

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

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

Get your publish token at clawsouls.ai/dashboard.

Sample Souls

79+ souls available — browse all at clawsouls.ai.

⚠️ Spec Version Compatibility

v0.5 souls with environment: "physical" include hardware, sensor, and safety fields intended for embodied agents (robots, IoT). Text-only agents (OpenClaw, ChatGPT, Claude) will safely ignore these fields — but the LLM may still interpret physical descriptions in SOUL.md as persona context. If you're using a physical soul with a text agent, set environment: "virtual" in soul.json or add fallback instructions in SOUL.md: "In text-only environments, omit physical action descriptions."

Soul Spec

Open standard. LLM-agnostic. Platform-portable.

• Soul Spec v0.5 — Latest
• Soul Spec v0.4
• Soul Spec v0.3

Links

• 📚 docs.clawsouls.ai — Full documentation
• 🌐 clawsouls.ai — Browse & install souls
• 📜 The Soul Thesis — Our manifesto
• 📄 Research Paper — "Soul-Driven Interaction Design" (Lee, 2026)
• 📦 npm: clawsouls — CLI
• 📄 License Guide — Allowed licenses
• 🐙 GitHub — All repositories

License

Apache 2.0 — see LICENSE

Disclaimer

ClawSouls is an independent, community-driven platform. Not affiliated with or endorsed by OpenClaw.