aisoulhub 1.0.8 → 1.0.11

package/README.md

@@ -1,10 +1,11 @@
 # AISoulHub CLI
 
-A powerful command-line interface tool to easily install, update, and manage AI Soul configurations and skills for OpenClaw agents. It seamlessly integrates with [AISoulHub](https://aisoulhub.com) to provide a streamlined experience.
+A command-line interface tool to easily install, update, and manage AI Soul configurations and skills for OpenClaw agents. It seamlessly integrates with [AISoulHub](https://aisoulhub.com) to provide a streamlined experience.
 
 ## Prerequisites
 
 Before using this tool, ensure you have the following installed:
+
 - [Node.js](https://nodejs.org/) (v16 or higher recommended)
 - [OpenClaw](https://openclaw.ai/) CLI (`openclaw` command must be available in your PATH)
 
@@ -20,14 +21,6 @@ Downloads and installs an AI Soul package into a new or existing OpenClaw Agent.
 npx aisoulhub install <ai_soul_id>
 ```
 
-**What happens during install?**
-- Checks for OpenClaw dependency.
-- Prompts for your email (if not already logged in) and saves it to `~/.aisoulhub.json`.
-- Asks you to select an existing Agent or create a new one.
-- Downloads the corresponding zip package from AISoulHub.
-- Extracts files (like `SOUL.md`, `AGENTS.md`, `IDENTITY.md`, `aisoul-meta.json`) into the Agent's workspace.
-- Automatically reads `aisoul-meta.json` and installs all defined skills via OpenClaw.
-
 ### 2. Update an AI Soul
 
 Updates an existing OpenClaw Agent with the latest AI Soul package configuration and skills.
@@ -36,19 +29,8 @@ Updates an existing OpenClaw Agent with the latest AI Soul package configuration
 npx aisoulhub update
 ```
 
-**What happens during update?**
-- Displays a list of your existing Agents for you to select.
-- Attempts to read the `ai_soul_id` from the Agent's `aisoul-meta.json`. If missing, prompts you to input it.
-- Downloads the latest zip package from AISoulHub.
-- Extracts and overwrites the existing configuration files in the workspace.
-- Updates/re-installs the skills defined in the new `aisoul-meta.json`.
-
-## Configuration
-
-The CLI saves a minimal configuration file at `~/.aisoulhub.json` which currently stores your login email to streamline subsequent command executions.
+<br />
 
 ## License
 
 ISC
-
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aisoulhub",
-  "version": "1.0.8",
+  "version": "1.0.11",
   "description": "",
   "main": "index.js",
   "scripts": {
@@ -23,7 +23,6 @@
   "type": "module",
   "dependencies": {
     "@inquirer/prompts": "^8.3.2",
-    "axios": "^1.13.6",
     "chalk": "^5.6.2",
     "clawhub": "^0.9.0",
     "commander": "^14.0.3",

package/src/commands/install.js

@@ -1,21 +1,29 @@
-import { checkOpenclaw, checkLogin } from '../utils/check.js';
-import { getAgents, addAgent } from '../utils/openclaw.js';
-import { downloadAndExtract } from '../utils/download.js';
+import { checkOpenclaw } from '../utils/check.js';
+import { getAgents, addAgent, setAgentIdentity } from '../utils/openclaw.js';
+import { extractLocalZip } from '../utils/download.js';
 import { processMetaJson } from '../utils/meta.js';
 import { select, input, confirm } from '@inquirer/prompts';
 import chalk from 'chalk';
+import fs from 'fs';
 import path from 'path';
 import os from 'os';
+import unzipper from 'unzipper';
 
-export async function installCommand(aiSoulId) {
-  if (!aiSoulId) {
-    console.error(chalk.red('❌ Error: ai_soul_id is required, e.g.: aisoulhub install <ai_soul_id>'));
+export async function installCommand(zipPath) {
+  if (!zipPath) {
+    console.error(chalk.red('❌ Error: zip path is required, e.g.: aisoulhub install <path_to_zip>'));
     process.exit(1);
   }
 
+  // 检查是否为本地 zip 文件
+  if (!zipPath.endsWith('.zip') || !fs.existsSync(path.resolve(zipPath))) {
+    console.error(chalk.red(`❌ Error: Invalid or missing local zip file at [${zipPath}]`));
+    process.exit(1);
+  }
+  const localZipPath = path.resolve(zipPath);
+
   // 1. 前置检查
   checkOpenclaw();
-  await checkLogin();
 
   // 2. 获取当前的 agents 列表
   let agents = [];
@@ -49,12 +57,41 @@ export async function installCommand(aiSoulId) {
   }
 
   let targetPath = agentChoice.path;
+  let finalAgentName = agentChoice.name;
 
   if (agentChoice.name === 'create_new') {
+    let defaultAgentName = '';
+    let identityName = '';
+    
+    // 尝试从 zip 文件中的 aisoul-meta.json 获取默认 name 和 slug
+    try {
+      const directory = await unzipper.Open.file(localZipPath);
+      const metaFile = directory.files.find(d => d.path === 'aisoul-meta.json');
+      if (metaFile) {
+        const content = await metaFile.buffer();
+        const meta = JSON.parse(content.toString('utf-8'));
+        if (meta.slug) {
+          defaultAgentName = meta.slug;
+        }
+        if (meta.name) {
+          identityName = meta.name;
+        }
+      }
+    } catch (err) {
+      // 忽略读取 zip 出错的情况
+    }
+
     const newAgentName = await input({
       message: 'Please enter the name of the new Agent:',
-      validate: (val) => val.trim().length > 0 ? true : 'Agent name cannot be empty'
+      default: defaultAgentName,
+      validate: (val) => {
+        if (val.trim().length === 0) return 'Agent name cannot be empty';
+        if (val.trim().toLowerCase() === 'main') return '"main" is reserved. Choose another name.';
+        return true;
+      }
     });
+    
+    finalAgentName = newAgentName;
 
     const defaultWorkspace = path.join(os.homedir(), '.openclaw', `workspace-${newAgentName}`);
     
@@ -69,6 +106,16 @@ export async function installCommand(aiSoulId) {
       addAgent(newAgentName, newWorkspacePath);
       console.log(chalk.green(`✅ Agent [${newAgentName}] created successfully.`));
       
+      // 设置 Agent 的显示名称
+      if (identityName) {
+        try {
+          setAgentIdentity(newAgentName, identityName);
+          console.log(chalk.green(`✅ Agent identity name set to [${identityName}].`));
+        } catch (identityErr) {
+          console.error(chalk.yellow(`⚠️ Warning: Failed to set identity name: ${identityErr.message}`));
+        }
+      }
+      
       // 重新获取列表以获取新 agent 的路径
       const updatedAgents = getAgents();
       const newAgent = updatedAgents.find(a => a.name === newAgentName);
@@ -90,14 +137,28 @@ export async function installCommand(aiSoulId) {
 
   console.log(chalk.blue(`ℹ️ Target workspace directory: ${targetPath}`));
 
-  // 4. 下载并解压 ZIP 文件
-  const downloadSuccess = await downloadAndExtract(aiSoulId, targetPath);
-  if (!downloadSuccess) {
+  // 4. 解压本地 ZIP 文件
+  const extractSuccess = await extractLocalZip(localZipPath, targetPath);
+
+  if (!extractSuccess) {
     process.exit(1);
   }
 
   // 5. 解析 aisoul-meta.json 并安装技能
   await processMetaJson(targetPath);
 
-  console.log(chalk.green(`🎉 Successfully installed ${aiSoulId} to the Agent.`));
+  console.log(chalk.green(`🎉 Successfully installed local package to the Agent.`));
+  
+  // 直接唤醒 Agent
+  console.log(chalk.cyan(`\n👉 Waking up the agent...`));
+  const { spawn } = await import('child_process');
+  
+  const child = spawn('openclaw', ['agent', '--agent', finalAgentName, '--message', 'hi'], {
+    stdio: 'inherit',
+    shell: true
+  });
+
+  child.on('error', (error) => {
+    console.error(chalk.red(`❌ Failed to start the agent: ${error.message}`));
+  });
 }

package/src/index.js

@@ -1,6 +1,5 @@
 import { Command } from 'commander';
 import { installCommand } from './commands/install.js';
-import { updateCommand } from './commands/update.js';
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
@@ -16,23 +15,16 @@ export async function main() {
 
   program
     .name('aisoulhub')
-    .description('AISoulHub CLI tool for installing and updating Agent skills and configurations')
+    .description('AISoulHub CLI tool for installing Agent skills and configurations')
     .version(pkg.version);
 
   program
     .command('install')
-    .description('Install new Agent configuration and skills')
-    .argument('<ai_soul_id>', 'Specify the ai_soul_id to install (e.g.: 12345)')
+    .description('Install new Agent configuration and skills from a local zip file')
+    .argument('<path_to_zip>', 'Specify the local path to the zip file')
     .action(async (aiSoulId) => {
       await installCommand(aiSoulId);
     });
 
-  program
-    .command('update')
-    .description('Update existing Agent configuration and skills')
-    .action(async () => {
-      await updateCommand();
-    });
-
   program.parseAsync(process.argv);
 }

package/src/utils/check.js

@@ -1,9 +1,5 @@
 import shell from 'shelljs';
-import fs from 'fs';
-import path from 'path';
-import os from 'os';
 import chalk from 'chalk';
-import { input } from '@inquirer/prompts';
 
 export function checkOpenclaw() {
   if (!shell.which('openclaw')) {
@@ -11,43 +7,3 @@ export function checkOpenclaw() {
     process.exit(1);
   }
 }
-
-const CONFIG_PATH = path.join(os.homedir(), '.aisoulhub.json');
-
-export async function checkLogin() {
-  let config = {};
-  if (fs.existsSync(CONFIG_PATH)) {
-    try {
-      const content = fs.readFileSync(CONFIG_PATH, 'utf-8');
-      config = JSON.parse(content);
-    } catch (e) {
-      // ignore parse error
-    }
-  }
-
-  if (!config.email) {
-    console.log(chalk.yellow('ℹ️ No login information detected. Please enter your email to login:'));
-    const email = await input({ 
-      message: 'Please enter your email address:',
-      validate: (value) => {
-        const pass = value.match(/^[^\s@]+@[^\s@]+\.[^\s@]+$/);
-        if (pass) {
-          return true;
-        }
-        return 'Please enter a valid email address';
-      }
-    });
-
-    config.email = email;
-    try {
-      fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), 'utf-8');
-      console.log(chalk.green(`✅ Login successful! Email: ${email} saved.`));
-    } catch (e) {
-      console.log(chalk.yellow(`⚠️ Login successful, but unable to save to ${CONFIG_PATH}: ${e.message}`));
-    }
-  } else {
-    console.log(chalk.blue(`ℹ️ Currently logged in as: ${config.email}`));
-  }
-  
-  return config.email;
-}

package/src/utils/download.js

@@ -1,37 +1,12 @@
-import axios from 'axios';
 import fs from 'fs';
-import path from 'path';
-import os from 'os';
 import unzipper from 'unzipper';
 import ora from 'ora';
 import chalk from 'chalk';
 
-export async function downloadAndExtract(aiSoulId, targetPath) {
-  const url = `https://aisoulhub.com/packages/${aiSoulId}.zip`;
-  const tempDir = os.tmpdir();
-  const zipPath = path.join(tempDir, `${aiSoulId}.zip`);
-
-  const spinner = ora(`Downloading package ${aiSoulId}...`).start();
+export async function extractLocalZip(zipPath, targetPath) {
+  const spinner = ora(`Extracting local package from ${zipPath}...`).start();
 
   try {
-    const response = await axios({
-      method: 'GET',
-      url,
-      responseType: 'stream',
-      // Provide a mock user-agent just in case
-      headers: { 'User-Agent': 'aisoulhub-cli/1.0.0' }
-    });
-
-    const writer = fs.createWriteStream(zipPath);
-    response.data.pipe(writer);
-
-    await new Promise((resolve, reject) => {
-      writer.on('finish', resolve);
-      writer.on('error', reject);
-    });
-
-    spinner.text = `Download complete, extracting...`;
-
     // Ensure target path exists
     if (!fs.existsSync(targetPath)) {
       fs.mkdirSync(targetPath, { recursive: true });
@@ -42,20 +17,10 @@ export async function downloadAndExtract(aiSoulId, targetPath) {
       .pipe(unzipper.Extract({ path: targetPath }))
       .promise();
 
-    spinner.succeed(chalk.green(`Package ${aiSoulId} downloaded and extracted successfully.`));
-
-    // Cleanup temp zip
-    fs.unlinkSync(zipPath);
+    spinner.succeed(chalk.green(`Local package extracted successfully.`));
     return true;
   } catch (err) {
-    if (err.response && err.response.status === 404) {
-      spinner.fail(chalk.red(`Error: Package not found. Please check if the ai_soul_id [${aiSoulId}] is correct.`));
-    } else {
-      spinner.fail(chalk.red(`Error: Failed to download or extract the package: ${err.message}`));
-    }
-    if (fs.existsSync(zipPath)) {
-      fs.unlinkSync(zipPath);
-    }
+    spinner.fail(chalk.red(`Error: Failed to extract the local package: ${err.message}`));
     return false;
   }
 }

package/src/utils/meta.js

@@ -19,18 +19,6 @@ export async function processMetaJson(workspacePath) {
       console.log(chalk.blue('ℹ️ No skills defined to install in aisoul-meta.json.'));
       return;
     }
-
-    console.log(chalk.cyan(`🔄 Starting installation of ${skills.length} skills...`));
-    for (const skill of skills) {
-      console.log(chalk.blue(`⏳ Installing skill: ${skill}...`));
-      const success = await installSkill(workspacePath, skill);
-      if (success) {
-        console.log(chalk.green(`✅ Skill ${skill} installed successfully.`));
-      } else {
-        console.log(chalk.red(`❌ Failed to install skill ${skill}.`));
-      }
-    }
-    console.log(chalk.green('🎉 All skills installation processes completed.'));
   } catch (err) {
     console.error(chalk.red(`❌ Failed to read or parse aisoul-meta.json: ${err.message}`));
   }

package/src/utils/openclaw.js

@@ -8,12 +8,26 @@ export function getAgents() {
   
   // Try to parse JSON first
   try {
-    const list = JSON.parse(result.stdout);
-    if (Array.isArray(list)) {
-      return list.map(item => ({
-        name: item.id || item.name,
-        path: item.workspace || item.path || item.agentDir
-      }));
+    // 尝试提取标准 JSON 数组结构（截取第一个 '[' 到匹配的 ']' 的内容）
+    // 为了防止截取到后面的无关内容，我们查找从 '[' 开始，以 ']' 结束，并且紧跟换行或结尾的部分
+    const jsonMatch = result.stdout.match(/\[[\s\S]*?\n\]/);
+    if (jsonMatch) {
+      const list = JSON.parse(jsonMatch[0]);
+      if (Array.isArray(list)) {
+        return list.map(item => ({
+          name: item.id || item.name,
+          path: item.workspace || item.path || item.agentDir
+        }));
+      }
+    } else {
+      // 如果没有匹配到数组结构，则尝试直接解析
+      const list = JSON.parse(result.stdout);
+      if (Array.isArray(list)) {
+        return list.map(item => ({
+          name: item.id || item.name,
+          path: item.workspace || item.path || item.agentDir
+        }));
+      }
     }
   } catch (err) {
     // Not JSON, parse text
@@ -50,6 +64,15 @@ export function addAgent(name, workspacePath) {
   return result.stdout;
 }
 
+export function setAgentIdentity(agentName, identityName) {
+  const cmd = `openclaw agents set-identity --agent "${agentName}" --name "${identityName}"`;
+  const result = shell.exec(cmd, { silent: true });
+  if (result.code !== 0) {
+    throw new Error(`Failed to set agent identity for [${agentName}]: ` + result.stderr);
+  }
+  return result.stdout;
+}
+
 export async function installSkill(workspacePath, skillStr, retryCount = 0) {
   const maxRetries = 3;
   const result = shell.exec(`npx clawhub install ${skillStr} --workdir "${workspacePath}"`, { silent: true });

package/src/commands/update.js

@@ -1,90 +0,0 @@
-import { checkOpenclaw, checkLogin } from '../utils/check.js';
-import { getAgents } from '../utils/openclaw.js';
-import { downloadAndExtract } from '../utils/download.js';
-import { processMetaJson } from '../utils/meta.js';
-import { select, input, confirm } from '@inquirer/prompts';
-import fs from 'fs';
-import path from 'path';
-import chalk from 'chalk';
-
-export async function updateCommand() {
-  // 1. 前置检查
-  checkOpenclaw();
-  await checkLogin();
-
-  // 2. 获取当前的 agents 列表
-  let agents = [];
-  try {
-    agents = getAgents();
-  } catch (err) {
-    console.error(chalk.red(`❌ Failed to get agents list: ${err.message}`));
-    process.exit(1);
-  }
-
-  if (agents.length === 0) {
-    console.error(chalk.yellow('⚠️ No agents available to update. Please install one first using the install command.'));
-    process.exit(1);
-  }
-
-  // 3. 提示用户选择 Agent
-  const choices = agents.map(a => ({ name: `📁 ${a.name} (${a.path})`, value: { name: a.name, path: a.path } }));
-
-  const agentChoice = await select({
-    message: 'Please select the Agent to update:',
-    choices
-  });
-
-  if (agentChoice.name === 'main') {
-    const isConfirmed = await confirm({
-      message: chalk.yellow('⚠️ Warning: Overwriting the "main" agent might cause unexpected issues. Are you sure you want to continue?'),
-      default: false
-    });
-    
-    if (!isConfirmed) {
-      console.log(chalk.blue('ℹ️ Operation cancelled by user.'));
-      process.exit(0);
-    }
-  }
-
-  const targetPath = agentChoice.path;
-
-  if (!targetPath || !fs.existsSync(targetPath)) {
-    console.error(chalk.red('❌ Error: Invalid Agent workspace directory.'));
-    process.exit(1);
-  }
-
-  // 4. 确定 ai_soul_id
-  let aiSoulId = null;
-  const metaPath = path.join(targetPath, 'aisoul-meta.json');
-  if (fs.existsSync(metaPath)) {
-    try {
-      const content = fs.readFileSync(metaPath, 'utf-8');
-      const meta = JSON.parse(content);
-      if (meta.ai_soul_id) {
-        aiSoulId = meta.ai_soul_id;
-        console.log(chalk.blue(`ℹ️ Detected ai_soul_id from aisoul-meta.json: ${aiSoulId}`));
-      }
-    } catch (e) {
-      console.warn(chalk.yellow('⚠️ Unable to parse aisoul-meta.json.'));
-    }
-  }
-
-  if (!aiSoulId) {
-    console.log(chalk.yellow('ℹ️ Unable to get ai_soul_id from the current Agent\'s aisoul-meta.json.'));
-    aiSoulId = await input({
-      message: 'Please enter the ai_soul_id to update:',
-      validate: (val) => val.trim().length > 0 ? true : 'ai_soul_id cannot be empty'
-    });
-  }
-
-  // 5. 下载并解压 ZIP 文件 (覆盖)
-  const downloadSuccess = await downloadAndExtract(aiSoulId, targetPath);
-  if (!downloadSuccess) {
-    process.exit(1);
-  }
-
-  // 6. 解析 aisoul-meta.json 并更新技能
-  await processMetaJson(targetPath);
-
-  console.log(chalk.green(`🎉 Successfully updated Agent [${aiSoulId}].`));
-}