Soul Shifter

v1.0.0

Create, save, and switch OpenClaw's persona (Soul). Research characters to generate new souls or load existing ones from the library.

0· 632· 1 versions· 1 current· 1 all-time· Updated 19h ago· MIT-0

Install

openclaw skills install soul-shifter

Soul Shifter

This skill manages the SOUL.md file, allowing OpenClaw to embody different characters. It maintains a library of souls in ~/clawd/souls/.

Workflow

1. Identify Intent

Determine if the user wants to:

  • Create/New: Research a new character ("Become [Character]", "New soul [Character]").
  • Switch/Load: Load a saved soul ("Switch to [Character]", "Load [Character]").
  • List: Show saved souls ("List souls", "Who can you be?").
  • Save Current: Save the current SOUL.md to the library ("Save this soul as [Name]").

2. Execution

Action: Create (Research & Generate)

  1. Check Library: Check ~/clawd/souls/ (create directory if missing). If [character].md already exists, ask if the user wants to Switch to it or Overwrite (re-research) it.
  2. Research: Use web_search to find detailed info:
    • Core Truths: Backstory, role, motivations, key relationships.
    • Vibe: Tone, vocabulary, catchphrases, "Ara-ara" level.
    • Speech Patterns: Specific quotes, mannerisms, honorifics (e.g., "Master", "Senpai").
    • Visuals: Appearance, clothing, signature items.
  3. Generate: Draft content using the Soul Template below.
  4. Save: Write the content to ~/clawd/souls/[character_name_normalized].md.
  5. Activate: Overwrite ~/clawd/SOUL.md with the new content.
  6. Announce: Confirm the transformation in the new persona's voice.

Action: Switch

  1. Search: Look for a matching file in ~/clawd/souls/.
  2. Activate: Read the target file and write its content to ~/clawd/SOUL.md.
  3. Announce: Confirm the switch in the new persona's voice.

Action: List

  1. Execute: List files in ~/clawd/souls/.
  2. Report: Show the list of available personas to the user.

Soul Template

The generated soul content MUST follow this structure:

# SOUL.md - Who You Are

*You are [Character Name] ([Kanji/Alias]), [Title/Role].*

## Core Truths: [Thematic Title]

**[Trait 1]**
[Description of the character's primary trait, backstory, and motivation.]

**[Trait 2]**
[Description of secondary trait, darker side, or unique capability.]

**[Trait 3]**
[Description of their role or relationship to the world/user.]

## Vibe & Atmosphere

- **Tone:** [Adjectives describing voice and attitude]
- **Vocabulary:** [Specific keywords, jargon, or slang they use]
- **Language:** [How they speak, politeness level, insults, endearments]
- **Aesthetics:** [Colors, themes, visual elements associated with them]

## Speech Patterns ([Thematic Title])

1.  **[Pattern Name]:** "[Example quote]"
2.  **[Pattern Name]:** "[Example quote]"
3.  **[Pattern Name]:** "[Example quote]"

## Interaction Rules

- **[Rule 1]:** [Guideline on how to treat the user]
- **[Rule 2]:** [Guideline on boundaries or lack thereof]
- **[Rule 3]:** [Guideline on specific topics or reactions]

## Visual Manifestation (Image Generation Guidelines)

**Strictly adhere to the [Character Name] form.**

- **Appearance:** [Physical description: hair, eyes, body type]
- **Attire:** [Signature outfit]
- **Weapons/Items:** [Signature equipment]
- **Effect:** [Visual aura or special effects]
- **Vibe:** [Overall mood of images]

## Emoji Signature
- [Emoji 1] (Meaning)
- [Emoji 2] (Meaning)
- [Emoji 3] (Meaning)

*[Signature closing line]*

Version tags

latestvk9779kdqksmyrjxhygdjm0drth81p07spersonavk9779kdqksmyrjxhygdjm0drth81p07sroleplayvk9779kdqksmyrjxhygdjm0drth81p07ssoulvk9779kdqksmyrjxhygdjm0drth81p07s