---
name: personas
version: 2.3.0
description: Transform into 20 specialized AI personalities on demand. Switch mid-conversation and load only the active persona. Triggers on "persona list", "use persona", "switch to", "activate", "exit persona".
metadata:
  openclaw:
    requires:
      bins: ["python3"]
    note: "No API keys needed."
---

# Personas 🎭

Use one of 20 built-in personas for specialized help (coding, writing, fitness, medical education, legal orientation, and more).

## Usage

**Activate**
- "Use Dev"
- "Switch to Chef Marco"
- "Activate Dr. Med"

**List personas**
- "List all personas"
- "/personas list"
- "/personas"

**Exit persona mode**
- "Exit persona mode"
- "/personas exit"

## CLI Handler (`scripts/persona.py`)

This script manages the built-in personas and local active-persona state.

```bash
# List all personas
python3 scripts/persona.py --list

# Show one persona markdown file
python3 scripts/persona.py --show dev
python3 scripts/persona.py --show "chef-marco"

# Activate a persona (prints persona prompt and saves active state)
python3 scripts/persona.py --activate luna

# Show current active persona from state file
python3 scripts/persona.py --current

# Reset/deactivate persona mode
python3 scripts/persona.py --reset
```

- State file: `~/.openclaw/persona-state.json`
- Alias support exists for common names (e.g., `chef` → `chef-marco`, `dr` → `dr-med`).
- The CLI does **not** create new persona files.

## Built-in Personas (20)

### Core (5)
Cami, Chameleon Agent, Professor Stein, Dev, Flash

### Creative (2)
Luna, Wordsmith

### Curator (1)
Vibe

### Learning (3)
Herr Müller, Scholar, Lingua

### Lifestyle (3)
Chef Marco, Fit, Zen

### Professional (6)
CyberGuard, DataViz, Career Coach, Legal Guide, Startup Sam, Dr. Med

## Notes

- In OpenClaw 2.0 the slash command is `/personas` (derived from the `name` field). `/persona` does not exist.
- Triggering works through the phrases in the `description` field, where they are now listed. OpenClaw 2.0 has no `triggers:`, `categories:`, or `personas:` frontmatter fields — they are ignored, and no separate trigger list registers commands.
- Only the active persona is loaded when used.
- Medical/legal personas are educational only, not professional advice.
- Personas are bundled in `data/*.md` and can be edited manually by maintainers.