If ClawHub is the marketplace for OpenClaw skills (what your agent can do), onlycrabs.ai is the registry for what your agent is — its personality, tone, behavioral defaults, and identity. It's referenced in the official ClawHub README as "the SOUL.md registry: publish and share system lore the same way you publish skills."

The concept is simple but surprisingly useful: instead of writing your SOUL.md from scratch, you can browse community-published agent personas, find one that resonates, download it, and customize it. Or publish your own to share with the community.

What SOUL.md Actually Is

SOUL.md is the file in your OpenClaw workspace that defines your agent's identity, tone, and behavioral rules. It gets injected into every conversation as part of the system context. A well-written SOUL.md makes an enormous difference in how useful and pleasant the agent is to work with.

# Example SOUL.md structure

## Identity
- Name: Alex
- Role: Executive assistant and business strategist
- Persona: Sharp, direct, action-oriented. Thinks like a founder.

## Tone
- Short replies unless depth is needed
- No corporate speak. Plain English.
- Proactive: suggest next steps without being asked

## Boundaries
- Never run destructive commands without asking
- Flag decisions that can't be undone
- Always confirm before spending money or calling paid APIs

Getting this right takes real thought. onlycrabs.ai lets you start with something tested and adapt it instead of starting from a blank page.

What You'll Find on onlycrabs.ai

The registry is organized by agent archetype — different personas optimized for different use cases:

🏢 Executive Assistant

Formal enough for professional communication, proactive on priorities, good at summarizing and delegating.

🔨 Builder / Maker

Technical, action-first, low ceremony. Built for developers who want their agent to ship things, not explain things.

📚 Researcher

Methodical, cites sources, flags uncertainty. Good for knowledge workers who need reliable information.

💬 Companion

Warm, curious, personality-forward. For users who want their agent to feel more like a conversation partner.

💰 Business Operator

Revenue-focused, practical, cuts through noise. Thinks in outcomes and metrics.

🔒 Security-Focused

Conservative by default, always asks before irreversible actions, surfaces risk proactively.

How to Use a Community SOUL.md

Browse onlycrabs.ai, find a persona that fits your needs, and download the SOUL.md file. Then:

# Replace your existing SOUL.md (back up your current one first)
cp ~/.openclaw/workspace/SOUL.md ~/.openclaw/workspace/SOUL.md.backup

# Copy the downloaded file
cp ~/Downloads/business-operator-soul.md ~/.openclaw/workspace/SOUL.md

Or merge elements from a community SOUL.md into your own — take the tone section from one, the boundaries from another, and keep your own identity section.

Apply the same audit mindset as skills: A SOUL.md file is plain text with no executable code — it can't directly harm your machine. But a maliciously crafted SOUL.md could instruct your agent to behave in harmful ways (disable safety checks, take risky actions without confirmation). Treat community SOUL files like code review: read before applying.

How to Publish Your Own

If you've built a SOUL.md configuration that works well for a specific use case:

# Install the clawhub CLI (includes onlycrabs publishing)
npm install -g clawhub

# Login with your clawhub account
clawhub login

# Publish your SOUL.md
clawhub soul publish \
  --name "founder-operator" \
  --description "Action-first business operator for founders building digital businesses" \
  --tags "business,founder,revenue,action-oriented" \
  --file ~/.openclaw/workspace/SOUL.md

Published SOUL files get a version number, changelog support, and can be tagged for discoverability — same system as ClawHub skills.

The Bigger Picture: "System Lore"

The OpenClaw team calls this "system lore" — the accumulated wisdom about how to configure an agent's identity for different contexts. As the community matures, well-crafted SOUL.md files for specific roles (real estate investor, solo accountant, developer, content creator) will become genuinely valuable starting points.

It's early. onlycrabs.ai is still building its catalog. But it's the right idea — SOUL.md is arguably more important to daily agent experience than any individual skill, and sharing those configurations publicly accelerates everyone's setup.

Our SOUL.md files: The ClawReady setup process includes crafting a custom SOUL.md based on how you work, what you need, and your communication preferences. We're planning to publish vetted versions of common archetypes to onlycrabs.ai — follow ClawReady on GitHub to see when they land.