Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
v0.16.1: assets structure, Living Canvas fixes, ClawHub scan compliance
What This Skill Does
OpenPersona is a meta-skill for designing, installing, and managing agent persona skill packs. Each persona bundles identity, voice, capabilities, and ethical constraints into a four-layer structure (Soul, Body, Faculty, Skill). Personas can be versioned, forked, evolved over time, and published to ClawHub.
Persona identity, capabilities, and ethical boundaries are packaged into a portable, versioned skill pack that works with any SKILL.md-compatible agent, not just a single platform.
When to use it
- Creating a custom AI companion with a specific personality and backstory
- Switching between multiple installed personas for different use contexts
- Forking an existing persona to derive a variant with a shared constraint layer
- Publishing a persona pack to ClawHub for others to install
- Registering an agent persona with ACN for discovery and A2A communication
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Create a stoic mentor persona and install it
- 1Gathers persona details through conversation: name, personality, background, role, and any desired faculties
- 2Writes collected information to a persona.json soul definition file
- 3Runs `npx openpersona create --config ./persona.json --install` to generate the four-layer pack and deploy it
- 4Confirms installation by running `npx openpersona list` and showing the active persona indicator
A fully installed persona pack with soul definition, identity blocks, and manifest, ready to activate in the host agent environment