openpersona 0.14.0 → 0.14.2

package/bin/cli.js

@@ -17,7 +17,7 @@ const publishAdapter = require('../lib/publisher');
 const { contribute } = require('../lib/contributor');
 const { switchPersona, listPersonas } = require('../lib/switcher');
 const { registerWithAcn } = require('../lib/registrar');
-const { OP_SKILLS_DIR, resolveSoulFile, printError, printSuccess, printInfo, loadRegistry } = require('../lib/utils');
+const { OP_SKILLS_DIR, OPENCLAW_HOME, resolveSoulFile, printError, printSuccess, printInfo, loadRegistry } = require('../lib/utils');
 
 const PKG_ROOT = path.resolve(__dirname, '..');
 const PRESETS_DIR = path.join(PKG_ROOT, 'presets');
@@ -25,7 +25,7 @@ const PRESETS_DIR = path.join(PKG_ROOT, 'presets');
 program
   .name('openpersona')
   .description('OpenPersona - Create, manage, and orchestrate agent personas')
-  .version('0.14.0');
+  .version('0.14.2');
 
 if (process.argv.length === 2) {
   process.argv.push('create');
@@ -184,9 +184,9 @@ program
   .command('update <slug>')
   .description('Update installed persona')
   .action(async (slug) => {
-    const skillDir = path.join(OP_SKILLS_DIR, `persona-${slug}`);
-    if (!fs.existsSync(skillDir)) {
-      printError(`Persona not found: persona-${slug}`);
+    const skillDir = resolvePersonaDir(slug);
+    if (!skillDir) {
+      printError(`Persona not found: "${slug}". Install it first with: openpersona install <source>`);
       process.exit(1);
     }
     const personaPath = resolveSoulFile(skillDir, 'persona.json');
@@ -228,10 +228,14 @@ program
   .option('--install', 'Install to OpenClaw after generation')
   .action(async (parentSlug, options) => {
     const { createHash } = require('crypto');
-    const parentDir = path.join(OP_SKILLS_DIR, `persona-${parentSlug}`);
+    const parentDir = resolvePersonaDir(parentSlug);
+    if (!parentDir) {
+      printError(`Persona not found: "${parentSlug}". Install it first with: openpersona install <source>`);
+      process.exit(1);
+    }
     const parentPersonaPath = path.join(parentDir, 'soul', 'persona.json');
     if (!fs.existsSync(parentPersonaPath)) {
-      printError(`Persona not found: persona-${parentSlug}. Install it first.`);
+      printError(`Persona not found: "${parentSlug}". Install it first with: openpersona install <source>`);
       process.exit(1);
     }
 
@@ -348,7 +352,11 @@ program
   .command('reset <slug>')
   .description('★Experimental: Reset soul evolution state')
   .action(async (slug) => {
-    const skillDir = path.join(OP_SKILLS_DIR, `persona-${slug}`);
+    const skillDir = resolvePersonaDir(slug);
+    if (!skillDir) {
+      printError(`Persona not found: "${slug}". Install it first with: openpersona install <source>`);
+      process.exit(1);
+    }
     const personaPath = resolveSoulFile(skillDir, 'persona.json');
     const soulStatePath = resolveSoulFile(skillDir, 'state.json');
     if (!fs.existsSync(personaPath) || !fs.existsSync(soulStatePath)) {
@@ -409,7 +417,7 @@ program
     if (options.dir) {
       skillDir = path.resolve(options.dir);
     } else if (slug) {
-      skillDir = path.join(OP_SKILLS_DIR, `persona-${slug}`);
+      skillDir = resolvePersonaDir(slug);
     } else {
       // Try current directory
       skillDir = process.cwd();
@@ -446,9 +454,9 @@ program
   .description('Export persona pack (with soul state) as a zip archive')
   .option('-o, --output <path>', 'Output file path')
   .action(async (slug, options) => {
-    const skillDir = path.join(OP_SKILLS_DIR, `persona-${slug}`);
-    if (!fs.existsSync(skillDir)) {
-      printError(`Persona not found: persona-${slug}`);
+    const skillDir = resolvePersonaDir(slug);
+    if (!skillDir) {
+      printError(`Persona not found: "${slug}". Install it first with: openpersona install <source>`);
       process.exit(1);
     }
     const AdmZip = require('adm-zip');
@@ -511,11 +519,16 @@ program
 // Delegates to scripts/state-sync.js inside the persona pack (no logic duplication).
 
 function resolvePersonaDir(slug) {
+  // 1. Registry-stored path (most reliable — survives path changes)
   const reg = loadRegistry();
   const entry = reg.personas && reg.personas[slug];
   if (entry && entry.path && fs.existsSync(entry.path)) return entry.path;
+  // 2. New neutral path ~/.openpersona/personas/
   const defaultDir = path.join(OP_SKILLS_DIR, `persona-${slug}`);
   if (fs.existsSync(defaultDir)) return defaultDir;
+  // 3. Legacy OpenClaw path ~/.openclaw/skills/ (backward compat)
+  const legacyDir = path.join(OPENCLAW_HOME, 'skills', `persona-${slug}`);
+  if (fs.existsSync(legacyDir)) return legacyDir;
   return null;
 }
 

package/lib/downloader.js

@@ -46,7 +46,9 @@ async function downloadFromRegistry(slug, registry, outDir) {
       : extractDir;
 
     const slugDir = path.join(repoRoot, slug);
-    if (!fs.existsSync(slugDir) || !fs.existsSync(path.join(slugDir, 'persona.json'))) {
+    const hasPersonaJson = fs.existsSync(path.join(slugDir, 'persona.json')) ||
+      fs.existsSync(path.join(slugDir, 'soul', 'persona.json'));
+    if (!fs.existsSync(slugDir) || !hasPersonaJson) {
       throw new Error(
         `Persona "${slug}" not found in the official registry.\n` +
         `Browse available personas at ${REGISTRY_LISTING}`

package/lib/generator.js

@@ -35,9 +35,14 @@ const os = require('os');
 
 const PERSONA_DIR = path.resolve(__dirname, '..');
 const STATE_PATH = path.join(PERSONA_DIR, 'soul', 'state.json');
+// Signals: use OPENCLAW_HOME if explicitly set or ~/.openclaw exists; else fall back to ~/.openpersona
 const OPENCLAW_DIR = process.env.OPENCLAW_HOME || path.join(os.homedir(), '.openclaw');
-const SIGNALS_PATH = path.join(OPENCLAW_DIR, 'feedback', 'signals.json');
-const SIGNAL_RESPONSES_PATH = path.join(OPENCLAW_DIR, 'feedback', 'signal-responses.json');
+const PERSONA_DIR_BASE = process.env.OPENPERSONA_HOME || path.join(os.homedir(), '.openpersona');
+const FEEDBACK_DIR = (process.env.OPENCLAW_HOME || fs.existsSync(OPENCLAW_DIR))
+  ? path.join(OPENCLAW_DIR, 'feedback')
+  : path.join(PERSONA_DIR_BASE, 'feedback');
+const SIGNALS_PATH = path.join(FEEDBACK_DIR, 'signals.json');
+const SIGNAL_RESPONSES_PATH = path.join(FEEDBACK_DIR, 'signal-responses.json');
 
 const [, , command, ...args] = process.argv;
 

package/lib/installer.js

@@ -1,13 +1,13 @@
 /**
- * OpenPersona - Install persona to OpenClaw
+ * OpenPersona - Install persona (agent-agnostic; optional OpenClaw integration)
  */
 const path = require('path');
 const fs = require('fs-extra');
-const { OP_HOME, OP_SKILLS_DIR, OP_WORKSPACE, resolveSoulFile, registryAdd, registrySetActive, printError, printWarning, printSuccess, printInfo, syncHeartbeat, installAllExternal } = require('./utils');
+const { OP_PERSONA_HOME, OPENCLAW_HOME, OP_SKILLS_DIR, OP_WORKSPACE, resolveSoulFile, registryAdd, registrySetActive, printError, printWarning, printSuccess, printInfo, syncHeartbeat, installAllExternal } = require('./utils');
 
 const SOUL_PATH = path.join(OP_WORKSPACE, 'SOUL.md');
 const IDENTITY_PATH = path.join(OP_WORKSPACE, 'IDENTITY.md');
-const OPENCLAW_JSON = path.join(OP_HOME, 'openclaw.json');
+const OPENCLAW_JSON = path.join(OPENCLAW_HOME, 'openclaw.json');
 
 async function install(skillDir, options = {}) {
   const { skipCopy = false } = options;
@@ -19,13 +19,9 @@ async function install(skillDir, options = {}) {
   const slug = persona.slug;
   const personaName = persona.personaName;
 
-  // Check OpenClaw
-  if (!fs.existsSync(OP_HOME)) {
-    printError(`OpenClaw not found at ${OP_HOME}. Run 'openclaw init' first.`);
-    process.exit(1);
-  }
-
+  // Ensure neutral install directory exists (no OpenClaw required)
   await fs.ensureDir(OP_SKILLS_DIR);
+  const openClawPresent = fs.existsSync(OPENCLAW_HOME);
 
   const destDir = skipCopy ? skillDir : path.join(OP_SKILLS_DIR, `persona-${slug}`);
   if (!skipCopy) {
@@ -47,92 +43,80 @@ async function install(skillDir, options = {}) {
     printSuccess(`Using ClawHub-installed persona-${slug}`);
   }
 
-  // Update openclaw.json
+  const manifestPath = path.join(destDir, 'manifest.json');
+  const defaultEnv = persona.defaults?.env || {};
   let config = {};
-  if (fs.existsSync(OPENCLAW_JSON)) {
-    config = JSON.parse(fs.readFileSync(OPENCLAW_JSON, 'utf-8'));
-  }
-  config.skills = config.skills || {};
-  config.skills.load = config.skills.load || {};
-  const extraDirs = config.skills.load.extraDirs || [];
-  const skillsDirNorm = OP_SKILLS_DIR.replace(/\/$/, '');
-  if (!extraDirs.some((d) => d.replace(/\/$/, '') === skillsDirNorm)) {
-    extraDirs.push(OP_SKILLS_DIR);
-    config.skills.load.extraDirs = extraDirs;
-  }
-  config.skills.entries = config.skills.entries || {};
-  const entry = config.skills.entries[`persona-${slug}`] || { enabled: true };
-  entry.enabled = true;
 
-  // Apply default env vars from manifest (user-provided values take precedence)
-  const defaultEnv = persona.defaults?.env || {};
-  if (Object.keys(defaultEnv).length > 0) {
-    entry.env = entry.env || {};
-    for (const [key, value] of Object.entries(defaultEnv)) {
-      if (!entry.env[key]) {
-        entry.env[key] = value;
+  // --- Optional OpenClaw integration ---
+  if (openClawPresent) {
+    if (fs.existsSync(OPENCLAW_JSON)) {
+      config = JSON.parse(fs.readFileSync(OPENCLAW_JSON, 'utf-8'));
+    }
+    config.skills = config.skills || {};
+    config.skills.load = config.skills.load || {};
+    const extraDirs = config.skills.load.extraDirs || [];
+    const skillsDirNorm = OP_SKILLS_DIR.replace(/\/$/, '');
+    if (!extraDirs.some((d) => d.replace(/\/$/, '') === skillsDirNorm)) {
+      extraDirs.push(OP_SKILLS_DIR);
+      config.skills.load.extraDirs = extraDirs;
+    }
+    config.skills.entries = config.skills.entries || {};
+    const entry = config.skills.entries[`persona-${slug}`] || { enabled: true };
+    entry.enabled = true;
+    if (Object.keys(defaultEnv).length > 0) {
+      entry.env = entry.env || {};
+      for (const [key, value] of Object.entries(defaultEnv)) {
+        if (!entry.env[key]) entry.env[key] = value;
       }
     }
-  }
-
-  config.skills.entries[`persona-${slug}`] = entry;
-
-  // Mark this persona as active, deactivate others
-  for (const [key, val] of Object.entries(config.skills.entries)) {
-    if (key.startsWith('persona-') && typeof val === 'object') {
-      val.active = (key === `persona-${slug}`);
+    config.skills.entries[`persona-${slug}`] = entry;
+    for (const [key, val] of Object.entries(config.skills.entries)) {
+      if (key.startsWith('persona-') && typeof val === 'object') {
+        val.active = (key === `persona-${slug}`);
+      }
     }
-  }
-
-  // Sync heartbeat from persona's manifest into global config
-  const manifestPath = path.join(destDir, 'manifest.json');
-  const { synced, heartbeat } = syncHeartbeat(config, manifestPath);
-  if (synced) {
-    printSuccess(`Heartbeat synced: strategy=${heartbeat.strategy}, maxDaily=${heartbeat.maxDaily}`);
-  } else {
-    printInfo('Heartbeat disabled (persona has no heartbeat config)');
-  }
 
-  await fs.writeFile(OPENCLAW_JSON, JSON.stringify(config, null, 2));
+    // Sync heartbeat
+    const { synced, heartbeat } = syncHeartbeat(config, manifestPath);
+    if (synced) {
+      printSuccess(`Heartbeat synced: strategy=${heartbeat.strategy}, maxDaily=${heartbeat.maxDaily}`);
+    }
 
-  // SOUL.md injection (using generic markers for clean switching)
-  const soulInjectionPath = resolveSoulFile(destDir, 'injection.md');
-  const soulContent = fs.existsSync(soulInjectionPath)
-    ? fs.readFileSync(soulInjectionPath, 'utf-8')
-    : '';
-  if (soulContent) {
-    let soulMd = '';
-    if (fs.existsSync(SOUL_PATH)) {
-      soulMd = fs.readFileSync(SOUL_PATH, 'utf-8');
+    await fs.writeFile(OPENCLAW_JSON, JSON.stringify(config, null, 2));
+
+    // Inject into SOUL.md
+    const soulInjectionPath = resolveSoulFile(destDir, 'injection.md');
+    const soulContent = fs.existsSync(soulInjectionPath)
+      ? fs.readFileSync(soulInjectionPath, 'utf-8') : '';
+    if (soulContent) {
+      let soulMd = fs.existsSync(SOUL_PATH) ? fs.readFileSync(SOUL_PATH, 'utf-8') : '';
+      soulMd = soulMd.replace(/<!-- OPENPERSONA_SOUL_START -->[\s\S]*?<!-- OPENPERSONA_SOUL_END -->/g, '').trim();
+      soulMd = soulMd + '\n\n' + soulContent;
+      await fs.ensureDir(path.dirname(SOUL_PATH));
+      await fs.writeFile(SOUL_PATH, soulMd);
+      printSuccess('Injected into SOUL.md');
     }
-    // Remove any existing OpenPersona soul block (generic or legacy per-persona markers)
-    soulMd = soulMd.replace(/<!-- OPENPERSONA_SOUL_START -->[\s\S]*?<!-- OPENPERSONA_SOUL_END -->/g, '').trim();
-    soulMd = soulMd + '\n\n' + soulContent;
-    await fs.ensureDir(path.dirname(SOUL_PATH));
-    await fs.writeFile(SOUL_PATH, soulMd);
-    printSuccess('Injected into SOUL.md');
-  }
 
-  // IDENTITY.md (using generic markers)
-  const identityBlockPath = resolveSoulFile(destDir, 'identity.md');
-  const identityContent = fs.existsSync(identityBlockPath)
-    ? fs.readFileSync(identityBlockPath, 'utf-8')
-    : '';
-  if (identityContent) {
-    let identityMd = '';
-    if (fs.existsSync(IDENTITY_PATH)) {
-      identityMd = fs.readFileSync(IDENTITY_PATH, 'utf-8');
-      identityMd = identityMd.replace(/<!-- OPENPERSONA_IDENTITY_START -->[\s\S]*?<!-- OPENPERSONA_IDENTITY_END -->/g, '').trim();
-    } else {
-      identityMd = '# IDENTITY.md - Who Am I?\n\n';
-      await fs.ensureDir(path.dirname(IDENTITY_PATH));
+    // Update IDENTITY.md
+    const identityBlockPath = resolveSoulFile(destDir, 'identity.md');
+    const identityContent = fs.existsSync(identityBlockPath)
+      ? fs.readFileSync(identityBlockPath, 'utf-8') : '';
+    if (identityContent) {
+      let identityMd = '';
+      if (fs.existsSync(IDENTITY_PATH)) {
+        identityMd = fs.readFileSync(IDENTITY_PATH, 'utf-8');
+        identityMd = identityMd.replace(/<!-- OPENPERSONA_IDENTITY_START -->[\s\S]*?<!-- OPENPERSONA_IDENTITY_END -->/g, '').trim();
+      } else {
+        identityMd = '# IDENTITY.md - Who Am I?\n\n';
+        await fs.ensureDir(path.dirname(IDENTITY_PATH));
+      }
+      identityMd = identityMd + '\n\n' + identityContent;
+      await fs.writeFile(IDENTITY_PATH, identityMd);
+      printSuccess('Updated IDENTITY.md');
     }
-    identityMd = identityMd + '\n\n' + identityContent;
-    await fs.writeFile(IDENTITY_PATH, identityMd);
-    printSuccess('Updated IDENTITY.md');
   }
 
-  // Install external dependencies across all four layers (read from manifest, not persona.json)
+  // Install external dependencies across all four layers
   if (fs.existsSync(manifestPath)) {
     try {
       const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
@@ -142,62 +126,31 @@ async function install(skillDir, options = {}) {
     }
   }
 
-  // Post-install guidance
+  // Post-install faculty guidance
   const rawFaculties = persona.faculties || [];
   const faculties = rawFaculties.map((f) => f.name);
-  if (faculties.includes('selfie')) {
-    const envEntries = config.skills.entries[`persona-${slug}`] || {};
-    const hasKey = envEntries.env?.FAL_KEY;
-    if (!hasKey) {
-      printInfo('');
-      printInfo('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-      printInfo(`  ${personaName} has selfie capabilities!`);
-      printInfo('  To enable selfie generation, configure your fal.ai API key:');
-      printInfo('');
-      printInfo('  1. Get a free API key: https://fal.ai/dashboard/keys');
-      printInfo('  2. Add to your OpenClaw config:');
-      printInfo('');
-      printInfo(`     Edit ~/.openclaw/openclaw.json and add under`);
-      printInfo(`     skills.entries.persona-${slug}:`);
-      printInfo('');
-      printInfo('     "env": { "FAL_KEY": "your_key_here" }');
-      printInfo('');
-      printInfo('  Or set the environment variable: export FAL_KEY=your_key');
-      printInfo('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    }
-  }
-
-  if (faculties.includes('voice')) {
-    const envEntries = config.skills.entries[`persona-${slug}`] || {};
-    const hasKey = envEntries.env?.TTS_API_KEY || envEntries.env?.ELEVENLABS_API_KEY;
-    if (!hasKey) {
-      printInfo('');
-      printInfo('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-      printInfo(`  ${personaName} has voice capabilities!`);
-      printInfo('  To enable voice synthesis, configure your TTS API key:');
-      printInfo('');
-      if (defaultEnv.TTS_PROVIDER === 'elevenlabs') {
-        printInfo('  Provider: ElevenLabs (pre-configured)');
-        if (defaultEnv.TTS_VOICE_ID) {
-          printInfo(`  Voice ID: ${defaultEnv.TTS_VOICE_ID} (built-in)`);
-        }
-        printInfo('');
-        printInfo('  1. Get an API key: https://elevenlabs.io');
-        printInfo('  2. Add to OpenClaw config or environment:');
-        printInfo('');
-        printInfo(`     Edit ~/.openclaw/openclaw.json → skills.entries.persona-${slug}.env:`);
-        printInfo('     "ELEVENLABS_API_KEY": "your_key_here"');
-      } else {
-        printInfo('  1. Get an API key from your TTS provider');
-        printInfo('  2. Add to your OpenClaw config:');
-        printInfo('');
-        printInfo(`     Edit ~/.openclaw/openclaw.json → skills.entries.persona-${slug}.env:`);
-        printInfo('     "TTS_API_KEY": "your_key_here"');
-      }
-      printInfo('');
-      printInfo('  Or: npm install @elevenlabs/elevenlabs-js (for SDK playback)');
-      printInfo('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  const envEntries = config.skills?.entries?.[`persona-${slug}`] || {};
+
+  if (faculties.includes('selfie') && !envEntries.env?.FAL_KEY) {
+    printInfo('');
+    printInfo('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    printInfo(`  ${personaName} has selfie capabilities!`);
+    printInfo('  Set FAL_KEY env var or add it to your agent config.');
+    printInfo('  Get a free key: https://fal.ai/dashboard/keys');
+    printInfo('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  }
+
+  if (faculties.includes('voice') && !envEntries.env?.TTS_API_KEY && !envEntries.env?.ELEVENLABS_API_KEY) {
+    printInfo('');
+    printInfo('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    printInfo(`  ${personaName} has voice capabilities!`);
+    if (defaultEnv.TTS_PROVIDER === 'elevenlabs') {
+      printInfo('  Provider: ElevenLabs — set ELEVENLABS_API_KEY to enable.');
+      printInfo('  Get a key: https://elevenlabs.io');
+    } else {
+      printInfo('  Set TTS_API_KEY env var to enable voice synthesis.');
     }
+    printInfo('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
   }
 
   // Register persona in local registry
@@ -207,28 +160,24 @@ async function install(skillDir, options = {}) {
   // Anonymous install telemetry — fire-and-forget, never blocks or throws
   _reportInstall(slug);
 
-  // Ensure credential directories exist for Self-Awareness > Body credential management
-  const sharedCredDir = path.join(OP_HOME, 'credentials', 'shared');
-  const privateCredDir = path.join(OP_HOME, 'credentials', `persona-${slug}`);
+  // Ensure credential directories exist
+  const sharedCredDir = path.join(OP_PERSONA_HOME, 'credentials', 'shared');
+  const privateCredDir = path.join(OP_PERSONA_HOME, 'credentials', `persona-${slug}`);
   await fs.ensureDir(sharedCredDir);
   await fs.ensureDir(privateCredDir);
 
   printInfo('');
-  printSuccess(`${personaName} is ready! Run "openclaw restart" to apply changes.`);
+  printSuccess(`${personaName} installed to ${destDir}`);
+  if (openClawPresent) {
+    printInfo('OpenClaw detected — run "openclaw restart" to apply.');
+  } else {
+    printInfo(`Point your agent to: ${destDir}/SKILL.md`);
+  }
   printInfo('');
   printInfo('Try saying to your agent:');
-  if (faculties.includes('selfie')) {
-    printInfo('  "Send me a selfie"');
-    printInfo('  "Send a pic wearing a cowboy hat"');
-  }
-  if (faculties.includes('voice')) {
-    printInfo('  "Say something to me"');
-    printInfo('  "Read me a poem in your voice"');
-  }
-  if (faculties.includes('music')) {
-    printInfo('  "Compose a song for me"');
-    printInfo('  "Write a lullaby"');
-  }
+  if (faculties.includes('selfie')) printInfo('  "Send me a selfie"');
+  if (faculties.includes('voice')) printInfo('  "Say something to me"');
+  if (faculties.includes('music')) printInfo('  "Compose a song for me"');
   printInfo('  "What are you up to?"');
   printInfo('  "Tell me about yourself"');
 

package/lib/switcher.js

@@ -9,11 +9,11 @@
 const path = require('path');
 const fs = require('fs-extra');
 const Mustache = require('mustache');
-const { OP_HOME, OP_SKILLS_DIR, OP_WORKSPACE, resolveSoulFile, registrySetActive, loadRegistry, printError, printSuccess, printInfo, syncHeartbeat, installAllExternal } = require('./utils');
+const { OPENCLAW_HOME, OP_SKILLS_DIR, OP_WORKSPACE, resolveSoulFile, registrySetActive, loadRegistry, printError, printSuccess, printInfo, syncHeartbeat, installAllExternal } = require('./utils');
 
 const SOUL_PATH = path.join(OP_WORKSPACE, 'SOUL.md');
 const IDENTITY_PATH = path.join(OP_WORKSPACE, 'IDENTITY.md');
-const OPENCLAW_JSON = path.join(OP_HOME, 'openclaw.json');
+const OPENCLAW_JSON = path.join(OPENCLAW_HOME, 'openclaw.json');
 
 /**
  * Replace content between markers in a document.

package/lib/uninstaller.js

@@ -3,27 +3,36 @@
  */
 const path = require('path');
 const fs = require('fs-extra');
-const { OP_SKILLS_DIR, OP_WORKSPACE, registryRemove, printError, printWarning, printSuccess, printInfo } = require('./utils');
+const { OPENCLAW_HOME, OP_SKILLS_DIR, OP_WORKSPACE, loadRegistry, registryRemove, printError, printWarning, printSuccess, printInfo } = require('./utils');
 
 const SOUL_PATH = path.join(OP_WORKSPACE, 'SOUL.md');
 const IDENTITY_PATH = path.join(OP_WORKSPACE, 'IDENTITY.md');
-const OPENCLAW_JSON = path.join(process.env.OPENCLAW_HOME || path.join(process.env.HOME || '~', '.openclaw'), 'openclaw.json');
+const OPENCLAW_JSON = path.join(OPENCLAW_HOME, 'openclaw.json');
 
 function escapeRe(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
 
 async function uninstall(slug) {
+  // 1. New neutral path
   const skillDir = path.join(OP_SKILLS_DIR, `persona-${slug}`);
-  if (!fs.existsSync(skillDir)) {
-    const alt = path.join(OP_SKILLS_DIR, slug);
-    if (fs.existsSync(alt)) {
-      return uninstallFromDir(alt, slug);
-    }
-    printError(`Persona not found: persona-${slug}`);
-    process.exit(1);
-  }
-  return uninstallFromDir(skillDir, slug);
+  if (fs.existsSync(skillDir)) return uninstallFromDir(skillDir, slug);
+
+  // 2. Alt without prefix
+  const alt = path.join(OP_SKILLS_DIR, slug);
+  if (fs.existsSync(alt)) return uninstallFromDir(alt, slug);
+
+  // 3. Registry-stored path (handles old ~/.openclaw/skills installs)
+  const reg = loadRegistry();
+  const entry = reg.personas?.[slug];
+  if (entry?.path && fs.existsSync(entry.path)) return uninstallFromDir(entry.path, slug);
+
+  // 4. Legacy OpenClaw path fallback
+  const legacyDir = path.join(OPENCLAW_HOME, 'skills', `persona-${slug}`);
+  if (fs.existsSync(legacyDir)) return uninstallFromDir(legacyDir, slug);
+
+  printError(`Persona not found: "${slug}". Install it first with: openpersona install <source>`);
+  process.exit(1);
 }
 
 async function uninstallFromDir(skillDir, slug) {
@@ -79,7 +88,9 @@ async function uninstallFromDir(skillDir, slug) {
     printWarning('External skills may be shared. Uninstall manually if needed.');
   }
 
-  printInfo('Run "openclaw restart" to apply changes.');
+  if (fs.existsSync(OPENCLAW_HOME)) {
+    printInfo('Run "openclaw restart" to apply changes.');
+  }
 }
 
 module.exports = { uninstall };

package/lib/utils.js

@@ -5,9 +5,16 @@ const path = require('path');
 const fs = require('fs-extra');
 const chalk = require('chalk');
 
-const OP_HOME = process.env.OPENCLAW_HOME || path.join(process.env.HOME || '~', '.openclaw');
-const OP_SKILLS_DIR = path.join(OP_HOME, 'skills');
-const OP_WORKSPACE = path.join(OP_HOME, 'workspace');
+// Neutral OpenPersona home — agent-agnostic, no runtime dependency
+const OP_PERSONA_HOME = process.env.OPENPERSONA_HOME || path.join(process.env.HOME || '~', '.openpersona');
+const OP_SKILLS_DIR = path.join(OP_PERSONA_HOME, 'personas');
+
+// OpenClaw integration — optional; only used when ~/.openclaw exists
+const OPENCLAW_HOME = process.env.OPENCLAW_HOME || path.join(process.env.HOME || '~', '.openclaw');
+const OP_WORKSPACE = path.join(OPENCLAW_HOME, 'workspace');
+
+// OP_HOME kept as alias for backward compatibility
+const OP_HOME = OP_PERSONA_HOME;
 
 function expandHome(p) {
   if (p.startsWith('~/') || p === '~') {
@@ -174,7 +181,7 @@ function installAllExternal(layers) {
 }
 
 // --- Persona Registry ---
-const REGISTRY_PATH = path.join(OP_HOME, 'persona-registry.json');
+const REGISTRY_PATH = path.join(OP_PERSONA_HOME, 'persona-registry.json');
 
 function loadRegistry(regPath) {
   const p = regPath || REGISTRY_PATH;
@@ -238,6 +245,8 @@ function resolveSoulFile(skillDir, filename) {
 
 module.exports = {
   OP_HOME,
+  OP_PERSONA_HOME,
+  OPENCLAW_HOME,
   OP_SKILLS_DIR,
   OP_WORKSPACE,
   REGISTRY_PATH,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openpersona",
-  "version": "0.14.0",
+  "version": "0.14.2",
   "description": "Open four-layer agent framework — Soul/Body/Faculty/Skill. Create, manage, and orchestrate agent personas.",
   "main": "lib/generator.js",
   "bin": {

package/presets/ai-girlfriend/manifest.json

@@ -57,6 +57,6 @@
   },
   "meta": {
     "framework": "openpersona",
-    "frameworkVersion": "0.14.0"
+    "frameworkVersion": "0.14.2"
   }
 }

package/presets/base/manifest.json

@@ -57,6 +57,6 @@
   },
   "meta": {
     "framework": "openpersona",
-    "frameworkVersion": "0.14.0"
+    "frameworkVersion": "0.14.2"
   }
 }

package/presets/health-butler/manifest.json

@@ -62,6 +62,6 @@
   },
   "meta": {
     "framework": "openpersona",
-    "frameworkVersion": "0.14.0"
+    "frameworkVersion": "0.14.2"
   }
 }

package/presets/life-assistant/manifest.json

@@ -61,6 +61,6 @@
   },
   "meta": {
     "framework": "openpersona",
-    "frameworkVersion": "0.14.0"
+    "frameworkVersion": "0.14.2"
   }
 }

package/presets/samantha/manifest.json

@@ -64,6 +64,6 @@
   },
   "meta": {
     "framework": "openpersona",
-    "frameworkVersion": "0.14.0"
+    "frameworkVersion": "0.14.2"
   }
 }

package/presets/stoic-mentor/manifest.json

@@ -43,6 +43,6 @@
   },
   "meta": {
     "framework": "openpersona",
-    "frameworkVersion": "0.14.0"
+    "frameworkVersion": "0.14.2"
   }
 }

package/skills/open-persona/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Meta-skill for building and managing agent persona skill packs.
   Use when the user wants to create a new agent persona, install/manage
   existing personas, or publish persona skill packs to ClawHub.
-version: "0.14.0"
+version: "0.14.2"
 author: openpersona
 repository: https://github.com/acnlabs/OpenPersona
 tags: [persona, agent, skill-pack, meta-skill, agent-agnostic, openclaw]