A dynamic persona management system that allows Openclaw Skills to research, save, and embody diverse character identities.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install soul-shifter
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-shifter 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 Shifter?
Soul Shifter is a sophisticated identity management framework designed to enhance the versatility of Openclaw Skills. It functions by managing the SOUL.md file, which serves as the core personality definition for the AI agent. This skill empowers the agent to transition between different 'Souls' or personas by researching character backgrounds, speech patterns, and behavioral traits from the web. By maintaining a localized library of these identities, it allows for a highly customizable and immersive user experience.
At its core, Soul Shifter bridges the gap between static AI responses and dynamic character embodiment. It provides the necessary tools for an agent to not only switch roles on the fly but also to perform deep research to ensure that every new persona is authentic to its source material. This makes it an essential tool for developers and users who want to push the boundaries of how Openclaw Skills interact and present themselves.
Soul Shifter Use Cases
- Rapidly researching and generating a brand-new character persona based on a specific prompt or character name.
- Seamlessly switching between a library of saved identities to change the agent's tone and expertise instantly.
- Creating and saving custom personas that represent specific brand voices or technical roles within Openclaw Skills.
- Listing and managing a library of available 'Souls' to keep track of various specialized agent behaviors.
How Soul Shifter Works
- The skill identifies the user's intent to either create a new persona, switch to an existing one, or list the current library.
- When creating a new soul, it utilizes web search tools to gather comprehensive data on character backstory, vocabulary, and aesthetics.
- It synthesizes the researched data into a standardized Soul Template, ensuring consistency across all Openclaw Skills personas.
- The generated content is saved as a Markdown file in the dedicated library directory at ~/clawd/souls/.
- To activate a persona, the skill overwrites the active ~/clawd/SOUL.md file with the content of the selected character soul.
- The AI agent immediately adopts the new identity, confirming the transformation in the specific voice and mannerisms of the persona.
Soul Shifter Setup
To get started with Soul Shifter in your Openclaw Skills environment, you must ensure the persona library directory is properly configured. Run the following command to initialize the directory:
mkdir -p ~/clawd/souls/
Once the directory is created, the skill will automatically handle the creation and management of soul files. No further manual configuration is required for basic persona switching and research functions.
Soul Shifter Data Schema & Taxonomy
Soul Shifter organizes data using a clear hierarchy within the Openclaw Skills file system. It relies on specific Markdown structures to define behavior.
| Component | Location | Description |
|---|---|---|
| Active Persona | ~/clawd/SOUL.md |
The current identity file that governs the agent's immediate behavior and tone. |
| Soul Library | ~/clawd/souls/*.md |
A collection of saved persona files that can be loaded or updated at any time. |
| Persona Template | Internal Schema | Includes Core Truths, Vibe & Atmosphere, Speech Patterns, and Interaction Rules. |
| Visual Manifestation | Metadata Section | Specific guidelines for image generation tools to ensure visual consistency of the character. |
Soul Shifter Advanced Features
- Integrated Web Research: Automatically fetches deep character lore and speech patterns to build authentic personas.
- Normalized Identity Storage: Maintains a clean library of Openclaw Skills personas for quick retrieval and organization.
- Image Generation Support: Includes strict visual manifestation guidelines to inform DALL-E or Midjourney prompts for the persona.
- Dynamic Voice Switching: Allows for instant transformation of speech patterns and vocabulary without manual editing.
- Conflict Resolution: Detects existing personas in the library and offers the choice to switch or overwrite during the research phase.
SKILL.md
Loading
Related Openclaw Skills
Soul Framework
A structural blueprint for transforming generic AI assistants into opinionated, persona-driven agents with deep long-term memory.
OKX API
A robust integration for OKX v5 REST and WebSocket APIs enabling automated crypto trading, account management, and real-time market data analysis.
Maliang Image Generation & Editing
An AI-powered image generation and editing skill for Openclaw Skills agents leveraging the Google Gemini model for high-quality visual creation.
Rationality Skill (Critical Fallibilism)
A structured logical framework for decision-making and error correction based on the binary evaluation principles of Critical Fallibilism.
EchoForge Moss Voice
A powerful text-to-speech skill for Openclaw Skills that leverages MOSS APIs to generate high-fidelity audio using specific voice IDs or cloned reference audio.
Zhipu Web Search
Integrate Zhipu AI's powerful web search API to provide AI agents with real-time, structured internet information and multi-engine capabilities.
Feishu Bot Manager
A comprehensive CRUD utility for managing Feishu bot configurations within the Openclaw ecosystem.
Featured*
