A persona management system for switching, previewing, and restoring AI identity configurations via a curated remote catalog.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install soul-search
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install soul-search using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Soul Persona Manager?
Soul is a specialized persona management skill designed to streamline how developers and power users interact with AI identities. By utilizing a curated remote catalog, it allows for the seamless application of SOUL.md files, which define the personality, tone, and operational constraints of an AI agent. It is a core component of the Openclaw Skills ecosystem that ensures your AI remains adaptable to different project requirements.
The skill provides a robust architecture for persona versioning and safety. It doesn't just overwrite files; it maintains a rigorous state management system that tracks provenance and creates automated backups before any changes are made, ensuring that your original configurations are never lost during the customization process.
Soul Persona Manager Use Cases
- Rapidly switching between different AI expert personas (e.g., Senior Architect to Creative Writer).
- Discovering new agent behaviors through a searchable remote catalog.
- Restoring previous AI configurations after testing new persona prompts.
- Syncing AI identity across different environments using a central persona repository.
How Soul Persona Manager Works
- The user issues a /soul command (such as list, search, or apply) through the Openclaw Skills interface.
- The skill executes a Node.js helper script that fetches and parses data from a trusted remote catalog URL.
- For previewing, the script retrieves raw content from the catalog to show the user the persona's traits.
- Upon applying a new persona, the system automatically backs up the existing SOUL.md file to a local backup directory.
- The new persona is written to the root, and state metadata is updated to track the change.
- The user is prompted to refresh the session to finalize the persona shift.
Soul Persona Manager Setup
To enable persona management within your Openclaw Skills environment, ensure you have Node.js installed and follow these steps:
# Navigate to your skill directory
cd skills/soul
# Ensure the scripts are executable (if applicable)
chmod +x scripts/soul.mjs
# Verify your environment has the required binaries
node --version
No additional manual configuration of the SOUL.md is required, as the skill handles directory creation for backups and state tracking automatically.
Soul Persona Manager Data Schema & Taxonomy
Soul organizes data systematically to ensure safety and transparency in persona transitions:
| Path | Purpose |
|---|---|
soul-data/backups/ |
Stores timestamped copies of SOUL.md before an overwrite. |
soul-data/state.json |
Contains provenance metadata, current persona ID, and source URLs. |
scripts/soul.mjs |
The logic engine responsible for catalog fetching and file I/O. |
SOUL.md |
The active persona file currently used by the AI agent. |
Soul Persona Manager Advanced Features
- Automated Backups: Every
applycommand triggers an automatic snapshot in thesoul-data/backups/folder to prevent data loss. - Provenance Tracking: Maintains a JSON-based state file to track the origin and history of applied Openclaw Skills personas.
- Search & Discovery: Integrated search functionality allows users to query the remote catalog by text to find the perfect persona for their task.
- Session Integrity: Built-in notifications remind users to use
/newor restart sessions to ensure the LLM fully adopts the updated persona constraints.
SKILL.md
Loading
Related Openclaw Skills
Language Tutor Pro
A persistent, conversation-driven AI language tutor that uses adaptive memory and spaced repetition to build fluency without gamification.
Git Factory
Git Factory provides automated worktree isolation for AI coding agents to ensure conflict-free parallel development.
Meal Planner Pro
Meal Planner Pro is an intelligent kitchen assistant that learns household tastes and dietary requirements to automate meal scheduling, shopping, and inventory tracking.
Clawtrix Skill Advisor
Clawtrix Skill Advisor is an intelligent auditing tool that optimizes your agent stack by removing unused code and recommending mission-critical Openclaw Skills using collective peer intelligence.
Memory Orchestrator
A sophisticated layered memory system for OpenClaw that organizes long-term knowledge, captures user preferences, and optimizes context window usage through progressive disclosure.
HTTP Header Analyzer
A professional-grade security auditing utility for Openclaw Skills that identifies missing HTTP security headers and analyzes TLS configurations.
METADATA
Featured*
