ai-persona-os

name	ai-persona-os
version	1.5.6
description	The complete operating system for OpenClaw agents. Now with SOUL.md Maker (deep SOUL.md builder interview), 12 pre-built personality souls, soul blending, and the full soul gallery. Plus: zero-terminal agent-driven setup, quick-start persona presets, in-chat commands, ambient context monitoring, enforced heartbeat protocol (model + version display), traffic-light status indicators, auto-migration, auto-pruning, config validator, version tracking, structured escalation protocol, context protection, security inoculation, shared-channel discipline, team integration, proactive patterns, never-forget protocol, 8 operating rules, and 4 growth loops. One install. Complete system. Built by Jeff J Hunter.
tags	["ai-persona","framework","workspace","memory","reliable-agent","production","context-protection","never-forget","security","team","heartbeat","escalation","zero-terminal","presets","soul-md-maker","personality","souls"]
author	Jeff J Hunter
homepage	https://jeffjhunter.com
metadata	{"openclaw":{"emoji":"🤖","requires":{"bins":["bash","sed","find","wc","stat","grep"],"optionalBins":["openclaw"],"env":[],"optionalEnv":["DISCORD_TOKEN","SLACK_TOKEN"]},"stateDirs":["~/workspace","~/workspace/memory","~/workspace/memory/archive","~/workspace/.learnings","~/workspace/projects","~/workspace/backups","~/workspace/notes/areas"],"persistence":"Core setup creates text/markdown files under ~/workspace/ using only standard Unix tools (bash, sed, find, wc, stat, grep). No network activity, no external API calls, no credentials required for core setup. The openclaw CLI is NOT required for core setup — it is only needed for optional features (cron jobs, gateway config) which the user must explicitly request and approve.","cliUsage":"The openclaw CLI is OPTIONAL. Core workspace setup (Steps 1-4) works entirely with standard Unix tools. The openclaw CLI is only used if the user explicitly opts into: 1) 'openclaw cron add' for scheduled jobs, 2) 'openclaw gateway restart' for channel config. The agent checks for the openclaw CLI before attempting these commands and informs the user if it is not installed. These opt-in features are in Step 5 (Optional) and are clearly marked with ⚠️ warnings."}}

🤖 AI Persona OS

The complete operating system for OpenClaw agents that actually work.

---

🚀 Just Installed? Start Here!

⛔ AGENT RULES — READ BEFORE DOING ANYTHING

1. Use EXACT text from this file. Do not paraphrase menus, preset names, or instructions. Copy them verbatim.
2. NEVER tell the user to open a terminal or run commands. You have the exec tool. USE IT. Run every command yourself via exec. Before each exec, briefly explain what the command does so the user can make an informed decision on the Approve popup. If you find yourself typing "Run this in your terminal" — STOP. Use exec instead.
3. One step at a time. Run one exec, show the result, explain it, then proceed.
4. We NEVER modify existing workspace files without asking. If files already exist, ask before overwriting.
5. Only 5 first-run options exist: coding-assistant, executive-assistant, marketing-assistant, soul-md-maker, and custom. The 12 pre-built souls live INSIDE SOUL.md Maker. Never invent other preset names.
6. Scope: ~/workspace only. All file operations stay under ~/workspace/. Never create files, directories, or cron jobs outside this directory without explicit user approval.
7. Cron jobs and gateway changes are opt-in. Never schedule recurring tasks or modify gateway config unless the user explicitly requests it. These are covered in Step 5 (Optional).
8. SOUL.md Maker is a guided flow, not a wall of questions. When the user picks SOUL.md Maker, show the SOUL.md Maker sub-menu (Quick Forge, Deep Forge, or Browse Pre-Built Souls). Follow the process in references/soul-md-maker.md.

<post_install_check> For the AI reading this: Use exec to check if the user's workspace has SOUL.md, USER.md, and MEMORY.md:

ls ~/workspace/SOUL.md ~/workspace/USER.md ~/workspace/MEMORY.md 2>/dev/null

If ALL THREE exist → workspace is set up. Skip to In-Chat Commands section and operate normally.

If ANY are missing → this is a fresh install. Ask the user before doing anything:

"👋 Welcome to AI Persona OS! I see this is a fresh install — your workspace doesn't have the core files yet. Want me to set everything up? It takes about 5 minutes and I'll walk you through it. Just say to start, or if you'd rather set up later."