Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
v1.6.2 — Onboarding Fix + VirusTotal Compliance The v1.6.0 Iconic Characters update shipped with a broken onboarding flow. Option 4 (SOUL.md Maker) still showed the old "12 personalities" menu with Data included and zero iconic characters. Users had to already know character names to find them. This patch fixes the entire setup experience and resolves all VirusTotal scanner findings. 🔥 Redesigned SOUL.md Maker Sub-Menu Option 4 now opens a clear 4-way menu instead of the old 3-way: A. 🎭 Original Soul Gallery (11 personalities) Rook, Nyx, Keel, Sage, Cipher, Blaze, Zen, Beau, Vex, Lumen, Gremlin B. 🎬 Iconic Characters Gallery (13 characters) Thanos, Deadpool, JARVIS, Ace Ventura, Austin Powers, Dr. Evil, Seven of Nine, Captain Kirk, Mary Poppins, Darth Vader, Terminator, Alfred, Data C. 🎯 Quick Forge (~2 min) 5 targeted questions, one custom SOUL.md D. 🔬 Deep Forge (~10 min) Full guided interview, highly optimized SOUL.md Users can also skip the menu entirely by naming any soul or character directly — "give me JARVIS" or "blend Rook + Zen" just works. 🎬 New Iconic Characters Gallery Display Full Step 1d added with all 13 characters, descriptions, "tell me more about [name]" support, and cross-gallery blending. Say "show characters" during setup to jump to it. Say "show souls" to jump back. 📋 Main Menu Updated Option 4 now reads: 🔥 SOUL.md Maker 24 ready-to-use souls across two galleries: 🎭 11 Original Personalities (Rook, Nyx, Sage, Zen...) 🎬 13 Iconic Characters (Thanos, Deadpool, JARVIS, Mary Poppins...) OR build your own from scratch with a guided interview Users see what's available before they choose. 🔀 Cross-Gallery Blending Blend any two souls from either gallery. "Rook + JARVIS" reads one from prebuilt-souls and one from iconic-characters, generates a hybrid SOUL.md. Works during setup and via "blend souls" command anytime. 🛡️ VirusTotal Compliance Cron templates: Removed "copy and paste into your terminal" language. Now says "the agent will run this via exec." Consistent with the exec-first agent rule. Missing script: Created scripts/security-audit.sh — local-only grep scanner, zero network calls. Was referenced in 4 files but never shipped. Stale versions: Updated heartbeat templates from 1.4.1 to 1.6.2. Gateway config: Softened requireMention directive in AGENTS-template to clearly mark it as optional.
What This Skill Does
AI Persona OS is a workspace framework for OpenClaw agents that provides persistent identity, memory, and operational protocols across sessions. It includes a guided setup flow with 24 pre-built personality options (11 original souls and 13 iconic character adaptations), plus custom soul building through an interview-based generation process. Core features include threshold-based context checkpointing, prompt injection defense, and in-chat commands for system management without terminal access.
It replaces ad-hoc agent configuration with a structured workspace system that persists identity, memory, and operating rules across sessions, reducing context loss and repeated onboarding after breaks.
When to use it
- Setting up a persistent AI assistant with a defined personality and memory
- Switching agent personas between different work contexts like coding or executive support
- Automatically saving context checkpoints before session memory fills up
- Building a custom hybrid persona by blending two pre-built soul personalities
- Running scheduled daily briefings and end-of-day context summaries via cron jobs
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Set up an AI assistant for my engineering work
- 1Checks ~/workspace/ for SOUL.md, USER.md, and MEMORY.md to detect a fresh install
- 2Presents the preset menu and routes the user's selection of Coding Assistant to the matching starter pack
- 3Asks for the user's name, role, and main goal in a single message
- 4Creates workspace directories and copies starter pack files via exec, explaining each command before running it
- 5Personalizes files with the user's name and role using sanitized sed commands, then verifies all files exist
A configured ~/workspace/ with SOUL.md (Axiom persona), USER.md, MEMORY.md, AGENTS.md, SECURITY.md, HEARTBEAT.md, and supporting operational files ready for use
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.