- name
- soul-searching
- description
- Browse, install, switch, and manage SOUL.md personality files for OpenClaw agents from the soulsearching.ai directory. Use when a user asks to: install a soul or personality, switch souls, list installed souls, browse available souls, check current soul, uninstall a soul, or anything related to SOUL.md management. Triggers on: install soul, switch soul, change personality, browse souls, soul search, what soul, current soul, list souls, remove soul, uninstall soul, personality file.
Soul Searching — SOUL.md Manager
Manage SOUL.md personality files from soulsearching.ai.
Commands
All commands use scripts/soul.sh in this skill's directory.
Browse available souls
./scripts/soul.sh browse [category]Categories: professional, creative, technical, funny, specialized, or omit for all.
Search souls
./scripts/soul.sh search <query>Install a soul
./scripts/soul.sh install <soul-id> [--activate]Downloads from soulsearching.ai and saves to ~/.openclaw/souls/<id>.md. With --activate, also copies to the workspace SOUL.md.
Switch to an installed soul
./scripts/soul.sh switch <soul-id>Backs up current SOUL.md → SOUL.md.bak, then copies the installed soul into place.
List installed souls
./scripts/soul.sh listShow current soul
./scripts/soul.sh currentUninstall a soul
./scripts/soul.sh uninstall <soul-id>Refresh catalog
./scripts/soul.sh refreshRe-downloads the catalog from soulsearching.ai.
Workflow
- Run
browseorsearchto find a soul - Run
install <id> --activateto install and activate in one step - Use
switchto swap between previously installed souls - Use
currentto check what's active
Notes
- Souls are cached locally in
~/.openclaw/souls/ - The catalog is cached at
~/.openclaw/souls/.catalog.json(auto-refreshes if >24h old) switchalways backs up the current SOUL.md before overwriting- The workspace SOUL.md path is auto-detected (current directory or
$OPENCLAW_WORKSPACE)