Personas

# 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" - "/persona list" - "/personas"

**Exit persona mode** - "Exit persona mode" - "/persona 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

- 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.