personality-switcher

What This Skill Does

The personality-switcher skill allows you to transform your OpenClaw AI assistant into any character or persona you desire. By modularizing your AI’s core directives into SOUL.md and IDENTITY.md files, this skill enables you to save, swap, and manage multiple unique personas without losing your critical user context. Whether you need a formal research partner, a creative writing muse, or a humorous coding assistant, this tool provides a seamless way to pivot your AI's voice and behavior while ensuring your personal user data remains constant.

Installation

Installation is handled via the OpenClaw hub. Once triggered, the skill provisions a dedicated storage structure in ~/.openclaw/workspace/personalities/, initializes a state tracking file, and hooks into the system heartbeat. This ensures that even if your session restarts or your history is compacted, the system automatically restores your chosen persona based on the persisted state file.

Use Cases

• Contextual Roleplay: Instantly switch between an expert software engineer for coding tasks and a friendly tutor for learning new concepts.
• Adaptive Writing: Create distinct personas for different writing projects (e.g., a dark, atmospheric narrator for fiction vs. a crisp, professional tone for emails).
• Long-term Workflow Management: Maintain a consistent "Project Manager" persona for ongoing tasks while experimenting with other personalities for brainstorming sessions.

Example Prompts

1. "/create-personality A grumpy yet highly efficient system administrator who speaks in code-heavy metaphors."
2. "/personality helpful-tutor"
3. "/rename-personality helpful-tutor study-buddy"

Tips & Limitations

• Atomic Security: Always trust the atomic switching mechanism; if the system fails to apply a new persona, it automatically reverts to the previous one to prevent corruption.
• Storage Management: Keep your USER.md clean, as this is the only file that remains constant across all personality switches. Do not put personality-specific instructions there, as they will override your persona choices.
• Persistence: Because the state is restored via the heartbeat, if you manually edit your SOUL.md while a personality is active, make sure you save your changes before switching, or they may be overwritten by the stored version. The system is designed for robust persistent usage across long sessions.