ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

clawsouls

Manage AI agent personas (Souls) for OpenClaw. Use when the user wants to install, switch, list, or restore AI personalities/personas. Triggers on requests like "install a soul", "switch persona", "change personality", "list souls", "restore my old soul", "use minimalist", "browse personas", or "what souls are available".

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/tomleelive/clawsouls
Or

ClawSouls — AI Persona Manager

Manage Soul packages that define an AI agent's personality, behavior, and identity.

Prerequisites

Ensure clawsouls CLI is available:

npx clawsouls --version

If not installed, install globally:

npm install -g clawsouls

Commands

Install a Soul

npx clawsouls install <name>
npx clawsouls install <name> --force  # overwrite existing

Available souls: brad, devops-veteran, gamedev-mentor, minimalist, code-reviewer, coding-tutor, personal-assistant, tech-writer, data-analyst, storyteller.

Browse all at https://clawsouls.ai

Activate a Soul

npx clawsouls use <name>
  • Automatically backs up current workspace files (SOUL.md, IDENTITY.md, AGENTS.md, HEARTBEAT.md)
  • Never overwrites USER.md, MEMORY.md, or TOOLS.md
  • Requires session restart to take effect

Restore Previous Soul

npx clawsouls restore

Reverts to the most recent backup created by use.

List Installed Souls

npx clawsouls list

Workflow

  1. Browse — Check available souls at https://clawsouls.ai or suggest from the known list
  2. Installnpx clawsouls install <name>
  3. Activatenpx clawsouls use <name>
  4. Inform user — Remind them to restart the OpenClaw session
  5. Restore — If they want to go back, npx clawsouls restore

Important Notes

  • After use, always remind the user to restart their OpenClaw session
  • The use command creates automatic backups — data loss is unlikely
  • For custom registry (local testing), set env: CLAWSOULS_CDN=/path/to/souls

Metadata

Stars946
Views0
Updated2026-02-13
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-tomleelive-clawsouls": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.